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4) 
A DIGITAL PRECISION 








If you are using a QL in any shape or form or with 
any accessory (thus including the new QXL 
68040, Gold Card, Trump Card, ST/QL, Thor, PC 
CONQUEROR, Minerva, TURBO, and even the 
humble unexpanded microdrive-only QL), you 
really should be using LIGHTNING SPECIAL 
EDITION. If not, you are very severely and 
unnecessarily (our program is quite inexpensive) 
slugging your system's performance. The superb 
LIGHTNING SPECIAL EDITION will both 
automatically and very significantly accelerate 
almost every aspect of QL operation - whatever it 
is you use the QL for. "More than 10x is 
achievable and 2x-4x is typical” 
(quote from page 24 of review in April '90 QL 
World). The speedup ratio is independent of the 
system. However fast or slow your hardware, 
LIGHTNING SPECIAL EDITION © will 
accelerate it much further. All recent versions of 
our software are carefully optimised for 16/32 bit 
processors, without compromising 8 bit working. 
The program has not got any adverse side effects 
at all, and it fixes QL anomalies. Installing it is a 
fast, once-only operation that takes two or three 
minutes and which assumes & requires absolutely 
no knowledge of programming or of anything even 
remotely technical about the QL: you are simply 
asked whether you wish to speed up text, maths 
and graphics individually, or everything. Unless 
you have a very good reason, opt for everything! 
Then LIsHTWING SPECIAL EDITION copies 
itself onto your boot-up disks, instantly modifying 
their BOOT files. Now every time you start up, full 
throughput acceleration is automatically invoked 
and everything goes much smoother and faster. In 
case you think that this is too good to be true, we 
quote verbatim the concluding para of the Sinclair 
QL World review: "J could not fault 
LIGHTNING SPECIAL EDITION on 
anything. It is a clear winner and 


a best buy at £49.95”. The program 
includes a bundle of accessories (change fonts 
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etc. in Quill etc., smooth scrolling and much more) 
and tweaks (vary maths and/or graphics precision, 
a null device and much more). Stop reading the 
manual where we tell you to - at around page four 
- if simple use is all that you want. The program 
also includes 84 excellent small fonts for use with 
both PERFECTION SPECIAL EDITION and 
PROFESSIONAL PUBLISHER: a real bonus! 


LIGHTNING SPECIAL EDITION includes 
both a ROM (for plugging in at the back of your QL 


- No screwdriver needed) and a disk. As some QL 
hardware (QXL; Gold Card for speed reasons) is 
not ROM-friendly, or you might have something 
already plugged in (ICE, TK2 if not already on 
your disk interface), you can get a version of the 
program minus the ROM for just £39.95: this is 


the GOLD CARD VERSION. If you have two 
QLs, say one of them a QXL / Gold Card and one 


“ordinary”, you should go for the full LIGHTNING 


SPECIAL EDITION. as you can use the ROM 
on the second machine. Extra ROMs cost £10 if 
ordered at the same time as the program, else £15. 

Q1) What programs benefit from LIGHTNING SPECIAL 
EDITION (LNGSE)? A) All, including emulators. Perhaps 
PERFECTION SE benefits most. Q2) Why didn't you bulld 
It into all your programs? A) It would be very inefficient to 
do so because of multitasking. Also, LNGSE benefits all 
programs (even Quill efc.), not just our ones. Q3) Does 
the QL "know" It Is running LNGSE? A) No. And It isn't 
“running” LNGSE either. In its first and only second of life 
LNGSE pages out, using a door deliberately left open by 
the QL's forward-thinking designer, large chunks of QDOS 
(AH, JM, JS, MG and all Minerva operating system 
variants) and replaces them with our fine-tuned supercode. 
Q4) Is It a compiler? A) No - TURBO Is. LNGSE greatly 
improves the performance of TURBO'd programs too! Q§) 
Why Is LNGSE so cheap? (happy users ask this) A) The 
truth is, we know that once you have experienced 
LIGHTWING SPECIAL EDITION, you won't abandon 
your QL. As THE QL software publisher, that Is rather good 
news for us. Q6) Give me one more reason for buying it. 
A) Look at our SPECIAL DEALS, and think. Even before 
any seasonal discount, LNGSE Gold Card would add a 
mere £30 to the price of PERFECTION PLUS SPECIAL 
EDITION, for example. SPECIAL DEALS allow you to get 
programs for free, even to get us to pay you to buy them... 
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In the case of many word-processing objectives, the best way to 
implement them is pretty clear. There are some areas, however, 
where individual tastes and preferences can differ very widely. 
One such area is the reformatting of text - the adjustment of 
previously entered text to conform to margin, indentation, 
justification and pagination settings after you go back (or 
forward!) to it and make alterations, either by hand (by typing 
and/or deleting) or by using individual or global search and 
replace. When new text is being entered at the foot of the 
document or at the end of the current paragraph, all word- 
processors behave virtually identically, obeying the current 
settings - it is in the matter of amending existing text (inserting, 
changing or deleting) where conflicting philosophies apply. Text- 
handlers differ in their treatment of this: Editor, Wordperfect, 
text87, Quill, AmiPro & Word all behave differently. 


Editor, Spy, most versions of Wordstar, and all technical editors 
leave all reformatting to you. While at first this may seem harsh, 
this manual mode gives you a lot of control, makes the handling of 
tables and other technical applications better (do you really want 
to reformat that BASIC program into a single paragraph?!?), and 
is easy on the eye. But you must remember to reformat as the 
program won't, and this may be an annoyance. If you move away 
and forget to clean up, your printout will probably be incorrect. 


Wordperfect will auto-reformat, but generally only when you 
move the cursor from the line containing the change. Changes you 
make while your cursor is within the line will only cause the line 
to contract or expand up to the margin. This too is easy on the eye, 
but there is the drawback that the overall picture of the page may 
be inaccurate while you are inserting or amending text, and that 
when you move the cursor away (and hence trigger the auto- 
reformat), you may not notice any undesirable effects caused (e.g. 
widows, orphans, inappropriately positioned page or line breaks). 


QL Quill auto-reformats, but because of its slowness it uses a 
trick: often when you start inserting within the middle of a 
paragraph, Quill splits the para in two and creates temporary blank 
lines to separate the parts. This means Quill does not need to 
reformat until you have finished amending. What you type appears 
at the end of the first part of the paragraph. This has the advantage 
and disadvantages of the Wordperfect method, but additionally the 
split can be a bit disconcerting and the screen display can be 
grossly wrong during the editing. Also, we know of a bug that 
causes a line to be shown twice on the Quill screen while it is only 
really present once: you will regret it if you delete the apparent 
duplicate as an unduplicated line will get deleted without warning. 


Word (a fine PC Windows program) auto-reformats in situ, in real 
time, as-you-type. But if you have a long complex para and you 
are editing near the top of it, you may notice the time taken for the 
reformat even on a 486/66MHz (QL users should note that this is 
>20 times faster than a Gold Card i.e. about the speed we expect 
from a fully tweaked QXL). Also, cursor movement will appear to 
some as a bit erratic (which is hard on the eye) especially if right 
justification is on or if the on-screen fonts are proportional. It can 
also be quite distracting to keep seeing the ripple effect of changes 
as text on lower lines is reformatted. AmiPro is somewhat better in 
this respect as there is a small delay (almost a second) before 
AmiPro refreshes lower lines on the screen: easier on the eye. 


The new release of PERFECTION SPECIAL EDITION, version 5, gives 
the user the best of all worlds, by combining the best of all the 
above methods and avoiding all the drawbacks. The user is given 
the opportunity both to pre-configure and to adjust at will from 
inside the program, the desired auto-reformatting behaviour. The 
options are to either select Never (giving Editor-like action for 
technical users: this is what all previous versions did, where you 
had to press a key to get the para to reformat after re-editing it), 
Instant (giving in-situ real-time automatic reformatting as-you- 
type, as does Word) or User-delay, the most flexible setting of all 


PERFECTION SPECIAL EDITION 
AN EXCITING NEW DEVELOPMENT 





Version 5! 


(giving slightly delayed updating of lower lines of text, like 
AmiPro, but also - and unlike AmiPro - giving you, the user, full 
control over how long the delay is). No other w.p. is this able. 


On User-delay the user is free to set any delay from 0.1 seconds to 
99.9 seconds in 0.1 second steps. About 1-2 seconds is best for 
slow typists, and 1.5 seconds is thus the default. This means that 
you are not hassled by continuing screen changes on lines below 
the one you are editing and concentrating upon, or shufflings 
around on the current line caused by right justification etc. So the 
Word disadvantage (much more noticeable on slower hardware) is 
avoided, without recourse to the Quill temporary blank line 
nuisance. When you pause in your typing for longer than the set 
delay, PERFECTION SPECIAL EDITION (SE) automatically tidies up, 
without you having to do anything (getting around the 
Wordperfect and Quill drawback of making you mentally adjust 
for the screen remaining occasionally out-of-sync with reality). 


If you are a reasonably fast typist, you can experiment with shorter 
delays (say 0.5 seconds). If you are a speed demon, set the delay to 
0.1 seconds and see if you can ever manage to "get ahead" of the 
program! Settings of under 0.3 seconds are indistinguishable from 
‘Instant’, when reformatting always keeps pace. 


On the User-delay setting PERFECTION SE will, as does Quill and 
Wordperfect, auto-reformat instantly (no matter how long a delay 
you have set) if you either navigate off the line or invoke any 
menu or direct command (including Save, Export etc.). This 
means that you are never left with the document "wrong". 


There are many other improvements in this release of PERFECTION SE. 
One in a similar area is with SHIFT/CAPS, the one (out of five) manual 
reformatting commands that allowed reformatting of a para from the 
current line onwards without affecting previous lines. SHIFT/CAPS will 
now additionally obey the indent margin (which matters if the cursor is on 
the first line of the para) and, more significantly, it will leave the cursor 
position unaltered within the text (previously, it used to move the cursor to 
the start of the next para). Other reformatting commands are unaltered, so 
you can still step through paras reformatting easily. 


PERFECTION SE v5 costs £99.95, or £139.95 in PLUS SE incarnation (i.e. with spellchecker, dictionaries 
& maintenance programs), less discounts that can total 40%. There is no special upgrade price to v5 
for existing SE owners - only DP's usual reasonable £10 update charge (but as an offer to AQLR 
readers, open for four weeks from the date of publication of this issue, existing SE or PLUS SE owners 
can get the upgrade totally free provided they order other DP programs of total value (after all 
discounts) exceeding £25). To upgrade from the STANDARD version of PERFECTION costs, as with 
all upgrades, the difference in price plus just £10, ic. £50. The user should not return any 
documentation, just the one master disk. Remember special deal prices, which give discounts of up to 
25% if more than one program is purchased (or upgraded) at the same time (do you have 
LIGHTNING SE?). To get the very best out of PERFECTION SE, use it with PROFESSIONAL 
PUBLISHER (and perhaps with attendant TOOLBOXes and FONT ENLARGER), when you can 
output text to any number of shapes of any desired complexity (not just boring columns!) throughout 
maintaining pixel proportional spacing and having thousands of fully WYSIWYG fonts to choose 


A\ll trademarks are acknowledged as belonging to their respective owners. 


from, whatever your printer.... 


OTHER SPECIAL PROGRAMS FROM DP 


PC CONQUEROR GOLD SPECIAL EDITION The rave review on pages 16 to 19 of 
March 1993 QL World really says it all: "an excellent product", "much faster, more compatible and capable 
than its predecessor". There are many extra features too. You can also get DR-DOS v6.0 (with Netware Lite 
free), which is the best DOS of all. And if you are buying or have bought this DOS from us, you can buy 
preconfigured DOS pseudo hard disks (on ED diskette) for £15 each (specify if you want compressed i.e. 
6Mb capacity, or 3Mb: or have one of each for £25). 

QMATHS MATHEMATICAL SYSTEM PART TWO A superb companion to 


QMATHS, with maths, stats, Abacus stuff, expression evaluation, terrain plotting, the fastest Mandelbrot 
routines and much more. Note the special price for 1+2. 

TRANSFER EDITION Copies and transfers, with optional sorting, 
case-changing, formatting, statistics and more. 

Superb print output from PRO PUBLISHER to HP Deskjets, Laserjets (the latter 
with 1Mb of RAM or more) and all compatibles. QUICKLASER costs just £19.95 all inclusive. 
LIGHTNING SPECIAL EDITION GOLD CARD VERSION Optimal speed from 
higher specified QLs - GOLD CARD, QXL, ST/QL, Thor XVI etc. Free upgrade from standard version if 
you return ROM + disk and are ordering something else at the same time, else £10 charge. 





PERFECTION 





PERFECTION PLUS 


Perfection Is the finest word processor available for any 
computer. We have received dozens of letters from 
happy users saying just this... and all of these letters 
were unsolicited. "Superb" was used most often. 


Perfection manages to achieve all the sophistication of 
the most complex PC word processors while still using a 
user Interface as friendly as Quill's. Perfection has a dual 
system of user control: menus while you are famillarising 
yourself with the program, and direct commands for the 
time when you feel ready for more adventurous things. 
The two systems can be used intercharigeably and even 
simultaneously. Even more exciting — both systems are 
Iterative. In case you don't understand what this means, 
let us give you an example: suppose you wished to move 
a block of text using the menus. You would choose Block 
Move (yes, it is right in the first menu) and the screen 
would then tell you to move your cursor to the start of 
the block. On most word processors you would have to 
navigate manually to this position: indeed, on many of 
them (Quill included) only a subset of the normal 
navigation commands would be available. On Perfection, 
not only can you use all the manual navigation 
commands (viz all 28 permutations of CTRL, ALT, SHIFT 
and the arrow keys!) but in addition you can use direct 
commands like GoTo Line or Page or any of eight 
markers. Even more amazingly, you can use Search 
(either as a direct command or from the menus) even 
though you are already 'within' a menu option. 


Perfection has about 200 commands, but the layout of 
menus and the choice of keys for the direct commands 
makes It very easy to master. Though a 100+ page 
manual is provided (with all the important bits right at 
the front), you should only need to consult it for 
specialised operations like macros. 


Even If speed is not particularly important to you, we 
assure you that Perfection's lightning performance will 
enable you to use the word processor in sensible ways 
that you would not have dreamed possible before. For 
example, scrolling 100 pages or so is accomplished so 
quickly using the normal navigation commands that you 
do not need to bother using a menu option to do the 
move. Spellchecking, assuming you have Perfection Plus, 
Is accomplished virtually Instantly: to spellcheck this 
whole ad (all the pages) would take under 1.5 seconds... 
Searching (you can switch case sensitivity, as well as 
equivalences between tabs, soft spaces and hard spaces) 
is at the rate of about 100 A4 pages per second. 


Moving from one word processor to another /s usually 
very traumatic. With Perfection, this will not be the case. 
Not only can Perfection read in Quill _doc and _exp files 
directly (you do not even need to tell it they are Quill 
files!) but it can make direct and immediate use of your 
existing Quill printer driver. File re-export is also possible. 


Perfection is truly WYSIWYG: this means that bold 
appears bold on screen, italics appear as italics, 
underlined as underlined, and so on. Of course, your 
printer may have functions we do not know about 
(upside down?). To deal with these, Perfection provides a 
number of on-screen shaded strips: these can be 
attached to any printer function you wish, and will not 
upset justification as a translate would. Of course, 
translates are provided as well! 


A variety of statistics on the document being processed 
are available: some of them are on view all the time, the 
rest can be toggled to instantly. Not only is there a word 
count, but also page, line, character and special 
character (like Superscript Off) counts. There are also a 
dozen status Indicators, letting you know whether you 
are in Insert or Overwrite mode, whether a block Is 
defined, whether interactive spelichecking Is enabled 
etc. Current line (from top as well as within page) and 
column positions and character codes are also available. 


A terrific feature of Perfection is the dual screen mode. 
You can view one part of the document while editing 
another. The sizes of the two windows are themselves 
adjustable, both In real-time or via the configurator. We 
should devote more space to the configurator: however, 
it must suffice to say that everything that could be 
dynamically set within Perfection may also be preset 
with the configurator. The configurator can, for 
example, allow you to select any of 256 colours for any 
of a dozen parameters (like paper colour, border colour, 
status window ink and paper colour etc). 


Perfection is fully multitasking without need for any 
external accessory: however, If you already use QPAC or 
Taskmaster or similar and are happy, you may go on 
doing so. 


There is absolutely no way that we can prepare you for 
the quality ‘feel’ of Perfection. We have a great deal of 
experience using PC word processors costing many 
hundreds of pounds: with absolutely no exception, 
Perfection is far easier to use and master. 


So If you thought Perfection was unattainable, you have 
a very pleasant surprise coming to youl 




























LIGHTNING SPECIAL EDITION 


LIGHTNING 


These programs accelerate QL operation by up to 10x (2x 
—4x is typical) without having any adverse effect 
whatsoever on compatibility or anything else. Lightning 
SE is typically 40% faster than the standard version. This 
acceleration is totally independent of, and in addition to, 
any speed-up obtained by hardware means. So if you 
have Gold Card, your need for Lightning SE is just the 
same as if you had only an unexpanded QL -— Lightning 
SE will accelerate both by the same ratio. 


The Lightning programs achieve their acceleration by 
automatically paging out sections of the QL's operating 
system and replacing these with optimal, concise code 
written by us. 


Lightning installation is a completely automatic and one- 
off: no knowledge of computing or programming is 
required. Once installed, Lightning can be completely 
forgotten about —- you will soon get used to the superb 
speed! Knob twiddlers are catered for too. 


Lightning technology Is not built in to any of our other 
programs. Perfection users (as well as users of all other 
QL software) should therefore use Lightning all the time. 


In summary: if you do not have Lightning, you are 
wrong. Buy this one ARST OF ALL! 


PROFESSIONAL PUBLISHER 


The’ Professional in Professional Publisher is 
Professional Publisher supplied with a generous 
refers to the quality of selection of fonts of vari- 
output from that program, ous sizes, as well as clip 
and is not meant to sug- 
gest any complexity of op- 
eration. Few programs are 
as easy to use as this 
one: 


99% KG ok 
users will \\ 
be able ae It is pointless for us to try 
to do , to list all of Professional 
with- ‘Publisher's features — we 
out using would end up filling half 
a manual! the magazine! We will 
Professional Publisher is by concentrate on just a few 
far the best DTP program '‘points': Professional 
for the QL. It Is fully com- Publisher Is extremely pre- 
patible with Perfection, cise, performing all its 
Editor, Quill, Eye-Q & the computations accurate to 
ASCIi editors. It allows you a small fraction of a mil- 
to both create and import _limetre. All its features can 
both text and graphics. be preset by you using its 
Text can be ‘poured’ into configurator, ruling out 
boxes of any shape, size the need for repetitive key 
and number, automatically strokes. 
maintaining justification The program is extraordi- 
and hyphenation settings. narily versatiie while re- 
So flowing text around maining Intuitive In its 
graphics is a doddle. user interface. Buy itl 


Justification 

is by pixel, not by 

character. This gives a 
much smoother effect. 





PROFESSIONAL PUBLISHER 
pele) :fe) ¢3 


Toolbox | is an excellent collection of high definition 
fonts, clip art and utility programs for Professional 
Publisher. While the fonts supplied with Professional 
Publisher are excellent, many users will feel the need for 


a wider range of typefaces and styles. 


Toolbox Il starts where Toolbox | leaves off, providing an 
even better — and different - font collection. 


The two Toolboxes complement each other and are 
available together at a special price. 





FONT ENLARGER 


GRAFIX 


Font Enlarger does exactly what you would expect It to 
from its name. While Professional Publisher is also 
capable of enlarging fonts, it does them ‘on the fly’ and 
consequently Is not able to remove the jaggedness 
caused by magnification. Font Enlarger is much cleverer, 
and enhances detail without any step effect. 





While the built-in printer driver for Professional 
Publisher is excellent with 9-pin printers, it is not optimal 
with 24-pin or laser printers. Grafix is. 
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EYE-Q 
ULTRAPRINT 


Eye-Q is the finest graphics program for the QL. While 
there may be other graphics programs with a few more 
features, no other program comes anywhere close to 
Eye-Q in sheer enjoyability. Eye-Q develops a pleasurable 
tactile relationship with you, and makes you feel like an 
artist (even if you aren't). Eye-Q graphics can be read in 
by Professional Publisher, and the latter's pages can be 
exported to Eye-Q (using Toolbox |). Everything in Eye-Q 
is menu-driven and there is context-sensitive help. 









While Eye-Q has its own printer driver, Ultraprint allows 
you 22 distinct styles/sizes of printer output. The 
reasoning Is that the scale of gradation suitable for 
pictures is probably unsuitable for text or line drawings. 
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SOLUTION 


PC Conqueror makes your QL into a PC-compatible 
machine,automatically. It does this by software means 
only, so there are no screws to undo or wires to fiddle 
with. Your QL stays a QL too. 


Why, might you ask, should you wish to make your QL 
into a PC-compatible? The reason is simple: you may wish 
to run the same programs at home as you do at work. 
Alternatively, you may wish to tap Into the vast 
storehouse of PC software of every type and description 
you could imagine. 


Using PC Conqueror could not be easier. Just boot up your 
machine with the PC Conqueror disk In floppy 1 and 
within 10 seconds your QL will be transformed into a PC 
that is just waiting to be switched on. From this point on 
you will do exactly the same as you would if you were 
running a ‘real’ PC — this means putting a DOS disk (any 


version) into one of your drives and pressing a key. If you 
do not already have legal access to a copy of DOS, we can 
provide you with one at reasonable cost (see our price 
list). 


PC Conqueror runs as fast as it is possible for a PC 
emulator to run: we have used all our skills to make it 
work quickly. Of course, you can make the emulation 
must faster by using Gold Card and Lightning SE. With 
this combination, you should get speed noticeably better 
than that of a PC XT... | 


PC Conqueror allows you to fine-tune the operating 
environment of the PC in order to improve performance. 
if you get a hard disk or other high capacity floppy 
system, you can utilise part or all of it as a PC hard disk. 


PC Conqueror occupies under 80K and leaves 667K free 
for DOS when run on a Trump Card. This is more than you 
will get on a ‘real’ PC. 


Solution does what Conqueror does but Is about half as 
fast and is not quite as compatible. 





SPELLCHECKER 
MEGA DICTIONARY 


Spelichecke” is what makes Perfection into Perfection 
Plus. We have made it available as a separate item for two 
reasons: (a) to allow Perfection owners to add It later 
(b) to allow users of other word processors to benefit 
from the very best in spelichecking technology. 


Spelichecker is supplied complete with three dictionaries 
of differing sizes as well as a system for building, 
reviewing and maintaining user dictionaries. 


Spelichecker’s ultimate accessory Is the Mega Dictionary, 
which gives the user a vocabulary of over 350,000 words! 


3D PRECISION CAD SYSTEM 





This program allows you to manipulate shapes and 
figures In 2D and 3D at a speed that will leave you 
breathless. Irrespective of whether your Interest is in CAD, 
in animation or in Just having fun, this program should 
not be missed. You can output to plotters directly from It, 
or alternatively create graphics screens to be manipulated 
and output by Eye-Q, Ultraprint or Professional Publisher. 


SUPER SPRITE GENERATOR 


SSG moves things about the screen very fast and very 
smoothly, without flicker. Sprites can have up to 16 frames. 



















MEDIA MANAGER SPECIAL EDITION 
MEDIA MANAGER 


Media Manager Special Edition (MMSE) is a program to 


be used both when things have gone wrong as well as 
when things are perfectly OK. It allows for automatic, 
semi-automatic and manual correction of a huge variety 
of disk and tape problems. It allows you to explore disks 
and tapes to your heart's content, producing all sorts of 
different diagnostic reports. MMSE is very simple to 
operate, being menu-driven and assuming no degree of 
computer knowledge whatsoever. 





MMSE also allows you to tidy, catalogue, sort and order 
your disks and cartridges. 


The standard Media Manager Is both less powerful and 
less user-friendly, but manages to work on an 
unexpanded QL. 


Both programs allow for data transfer between PC and 
QL. With MMSE, this transfer is at file and directory level, 
Is bi-directional and Is completely automatic. 





SPECIAL DESKTOP PUBLISHER 
DESKTOP PUBLISHER 


These programs are quite primitive compared to 
Professional Publisher. However, if you have not 
experienced that program as yet, you will find both of 
these very competent. Both are capable of producing 
excellent results. The cheaper one has fewer features but 
is able to run on smaller systems. 











EDITOR SPECIAL EDITION 
THE EDITOR 


With the sole exception of Perfection, this Is the best 
word handling system on the QL. Editor's features 
Include an unrivalled degree of programmability and the 
ability to cope with the entire 256 character ASCII set. 
The Special Edition has enhanced document-type 
facilities, Including column blocks and on-screen page 
break displays. Neither program Is suitable for 
computing novices. Until Perfection, Editor Special 
Edition would have been our ‘Desert Island Program’. 


Editor SE can do a few things that Perfection can't, so 
the ideal combination is to have both (they are 
compatible at file level and can multitask). If you order 
Editor SE at the same time as Perfection, you can have 
Editor SE at half price. 


PROFESSIONAL ASTROLOGER 
PROFESSIONAL ASTRONOMER 


The Astrologer program teaches you Astrology from 
scratch and enables you to automatically produce text 
narrative on personality delineation, year-to-year and 
minute-to-minute life predictions, compatibility 
interpretations and so on. Whether or not you believe in 
astrology — indeed, especially if you do not — this 
program Is one that you cannot afford to have. You can 
tailor the readouts (both in terms of quantity and what 
is said) to your own particular requirements. The amount 
of fun you can have with this program is endless. Do not 
blame us if you start believing in astrology, though! 


Astronomer is an extremely fast and accurate solar 
system calculator, with planetarium views, planet faces, 
eclipses, cinerama display etc.. 


TURBO BASIC COMPILER 


Turbo is the finest BASIC compiler for the QL and 
arguably the finest BASIC compiler for any computer! 


Turbo automatically converts working BASIC programs 
into optimised machine code, usually with no need for 
human intervention. The benefits of this conversion are 
vastly enhanced running speed (as well as much faster 
loading, encryption and automatic bug fixing for a variety 
of QL interpreter oddities). Typical speed-up is 40x — 100x. 


Turbo Is provided with a 200 command toolkit, adding 
many useful commands to BASIC. Most of these 
commands will be of immediate use to the programmer, 
whether he is a novice or an expert. There are commands 
to load strings and floats into RAM, and to extract them 
automatically; to search memory and to move its contents; 
to control jobs and change their priorities, manage pipes, 
allocate and deallocate memory, to control both rubber 
and virtual arrays, to present INPUT with an editable 
default, to have random access to files and much more. 









TOOLKIT Ill : 


Toolkit Ill starts where Toolkit Il stopped, adding about 
60 new commands and enhancing many existing dual 
functions. Toolkit Ill Is available either on disk or on 
ROM, and works whether or not you have Toolkit Il. 


Toolkit Ill commands can, with only a couple of 
exceptions, be compiled using Turbo. 


QFLICK CARD INDEX 


All QL owners have a copy of Archive, supplied free with 
the QL. While Archive Is competent, it is very hard to get 
to grips with and Is not particularly fast. QFlick presents 
a very convenient alternative — a snappy , simple-to-use, 
pointer-controlled card file database. You can move data 
between QFlick and Archive in either direction. 


QFlick Is not itself programmable but we document Its 
data structure and give guidance on how to program It 
using Turbo. 


ARCHDEV + RTM 
DATABASE ANALYSER 
ARCHIVE TUTORIAL 
NAMES + ADDRESSES 
MAILMERGE 
DAT-APPOINT 
SEDIT 
SCREENPRINT 
RECOVER 


This suite of utilities will greatly enhance your use of the 
Archive database system. 


Archdev + RTM Is a straight replacement for Archive: It 
gives enhanced speed, greater workspace and a much 
cleaner boot-up. All your existing applications will work. 


Database Analyser provides very fast and comprehensive 
statistics about your Archive databases. 


Archive Tutorial proceeds systematically through the 
whole philosophy and grammar of Archive, providing 
you with expert and patient guidance. 


Names + addresses, Mailmerge and Dat-Appoint are 
ready-to-run, off-the-shelf Archive applications, 
providing an address database, malimerging and 
appointment diary respectively. You now have no excuse 
not to use Archive. 


SEdit allows you to create and edit screen format files in 
Archive. Screenprint allows you to print them out. 


Recover allows you to get back lost Archive databases, 
created when you switched off the computer without 
properly exiting from Archive. 





XREF 
SUPERBASIC MONITOR 
BETTERBASIC EXPERT SYSTEM 


XRef analyses the structure of a BASIC program, 
providing detailed reports on things like variable usage, 
what calls what, dynamic call hierarchy of procedures 
and functions, and so on. 


SuperBasic monitor actually monitors and reports on the 
performance of BASIC programs as they run under the 
interpreter. 


BetterBasic analyses and automatically corrects structural 
flaws In your programs and allows you to customise 
things like indentation, number of statements per line, 
filtering out of noise words, etc. 


The three programs together provide a matchless 
diagnostic and auto-correcting facility for BASIC 
programs. 


TRANSFER UTILITY 


This program copies files at high speed between devices, 
performing translates as it goes along. Ideal for all sorts of 
applications, including transfers from microdrive to disk. 





QMATHS SYSTEM 


This Is an Incredible mathematical compendium for the 
QL. Pride of place goes to the symbolic problem solver: 
this can solve equations, simplify expressions, factorise, 
expand, etc, all symbolically. If you could sneak this one 
into a maths examination, you would have a formidable 
ally. QMaths knows about all the algebraic operators, 
powers, roots, brackets, trigonometry, matrices, 
determinants, vectors, factorials, permutations, 
combinations, binomials, exponentials, logarithms, 
hyperbolics, Inverse functions, infinite series including 
Taylor & Maclaurin expansions, complex numbers, 
conversions, Fourler series, and lots of calculus: both 
differential and integral, induding integration by parts 
and definite integrals. QMaths optionally displays its 
workings and comes with a superb interactive tutorial. 


The package also contains an interpretive, fractal, Image- 
generating language with loads of beautiful fractal 
programs supplied for you to use and edit - no 
programming skill is required. 


There Is also a multiple precision floating point maths 
package, giving calculations at precisions up to over 600 
decimal digits of accuracy. 


There is even more to this system, but we think we have 
told you enough. 


QMON MACHINE CODE MONITOR 


The latest version of Tony Tebby's superb monitor: an 
absolute must for those who really want to know what 
Is going on in the QL. No other machine code monitor 
even comes close. 


Do not confuse this program with SuperBasic monitor, 
which monitors SuperBasic, not machine code. 


COMPARE 


This program compares files — data or program - at 
colossal speed. Where a mismatch is detected, the 
relevant areas are highlighted and you can shuffle, 
displace and align very easily. 


CASH TRADER WITH ANALYSER 
PAYROLL 


Cash trader with Analyser is an accounts system designed 
by businessmen and not by wretched accountants! 
Consequently, it has excellent reporting and 
management facilities, and is very flexible. It is almed 
primarily at the layman, probably a sole trader running a 
small or medium sized business. All the features you 
would expect - Including audit trall — are present. 


Payroll is a reasonably flexible system designed to 
automate the payroll function in small businesses. 


Both programs are configurable, with editable defaults 
letting you adapt the programs from year to year. 


HARDBACK WITH FINDER 


This is the ultimate hard disk backup and management 
utility, with all the sophisticated features you could 
want. User dialogue is via overlapping pop-up windows — 
the whole program Just feels right. It is possible to scan 
the disk at great speed, too. 
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This permits you to add password protection to disks, to 
optionally increase disk storage capacity on DSDD drives 
by 36K and to increase speed of access by as much as 
30%. All this is done while maintaining full compatibility. 
Automatic file management is also provided. 


DIGITAL C SPECIAL EDITION 
DIGITAL C 


These are extremely fast and efficient C compilers, 
complying with and surpassing the Small C definition. 
The Special Edition goes much further, including support 
for structures, pointers, long pointers, >64K code size, 
direct access to QDOS traps, etc. The Special Edition C 
generates code that runs about twice as fast as the other. 





SPECIAL DEALS 


5% off total if you buy 2 programs/upgrades; 


10% off 3; 15% off 4; 20% off 5; 25% off 6+ 
Upgrades cost difference in price + £10 
Non-UK Europe add 5%, rest of world 10% 


For full terms ond conditions, please refer to any of our QL World ads from Jan—Nov 1990, or write in Including a SAE 


CPORT IMPROVED VERSION 


A brand new CPORT system, enabling you to rapidly 
convert your SuperBASIC programs into C (ANSI or 
Lattice). The new (October 1992) version is now as 
close to being fully automatic as makes no difference 
— you must get it! 


Owners of our earlier CPORT versions should return disk + SAE for a free upgrade. 















SUPERFORTH COMPILER WITH REVERSI 


Forth is the most logical computer language. This compiler produces multitasking code. 
The manual teaches you Forth-83 from scratch. 


IDIS SPECIAL EDITION 
IDIS 


These intelligent disassemblers make the otherwise terrifyingly complex task of 
understanding other people's machine code programs absurdly easy. The SE version, 
which has a higher hardware requirement, sorts out some routines, replaces addresses 
with names, untangles data from code and much more. 


QKICK FRONT END SYSTEM 


This is a simple, easy-to-master, pull-down menu controlled multitasking front end. QKick 
runs In the background and can be called up at any time. It provides you with notepads, 
sophisticated file/sector/RAM handling, backing up facilities, a clock, diary, calculator, 
mini-database and so on. 






















ADVENTURE CREATION TOOL SPECIAL EDITION 


ACT is a must for every programmer. The name of the program Is misleading, insofar as it 
has capabilities far beyond the ‘mere’ creation of adventures. ACT has utilities providing 
animated graphics, data compression, language design, parsing, maps, object-oriented 
control etc. If all you want to do is generate adventures, though, you do not need to be 
a programmer to use it. This is a purchase you will never regret. 


A fast, modern and capable printer driver for the programs bundled with the QL. 
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Superb contract bridge bidder (ACOL etc) and player, using millions of random but 
reconstructable hands. Microbridge also includes a state of the art interactive bidding 
tutor and a clear Instruction manual. There is nothing like this anywhere else! 


SUPER ASTROLOGER 


A very cut-down version of Professional Astrologer — still great fun, though! 


SUCCESS CP/M EMULATOR 


Allows your QL to run CP/M programs at great speed. 
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3-D PRECISION CAD SYSTEM 49.95 
ADVENTURE CREATION TOOL SPECIAL EDITION 49.95 
ARCADIA GAME 9.O5 
ARCHIVE DEVELOPMENT SYS + RUN-TIME MODULE L593 
ARCHIVE TUTORIAL 19E95 
BETTER BASIC EXPERT SYSTEM 24.95 
BLOCKLANDS GAME 9395 
CASH TRADER v3.3 + ANALYSER 99.35 
COMPARE FILE UTILITY 19.95 
COPY UTILITY FOR BACKING UP 9:95 
CPORT BASIC TO C TRANSLATOR WITH C68K COMPILER 99.95 
CPORT BASIC TO C TRANSLATOR 89.95 
DATABASE ANALYSER FOR ARCHIVE 19.95 
DAT—APPOINT APPOINTMENT DATABASE SYSTEM 19.95 
DESKJET/LASERJEI DRIVER FOR PRO PUBLISHER 19:95 
DESKTOP PUBLISHER SPECIAL EDITION 39.495 
DESKTOP PUBLISHER 24.95 
DIGITAL C COMPILER 29.95 
DIGITAL C SPECIAL EDITION 49.95 
DISKTOOL WITH QUICKDISK 19.95 
DROIDZONE GAME 9.95 
DR-DOS v6.0 STATE OF THE ART PC OPERATING SYSTEM 79.95 
EDITOR SPECIAL EDITION 49.95 
EDITOR yA Pe 
EYE-Q GRAPHICS SYSTEM 39.95 
FONT 19595 
GAMES COMPENDIUM (ALL FIVE te 29595 
GRAFIX 24—-PIN UNIVERSAL PRINTER DRIVER 14.95 
HARDBACK + FINDER HARD DISK MANAGER 49.95 
IDIS INTELLIGENT DISASSEMBLER 24.95 
IDIS SPECIAL EDITION 37 oo0 
LIGHTNING ACCELERATOR 24.95 
LIGHTNING SPECIAL EDITION ACCELERATOR 49.95 
LIGHTNING SPECIAL EDITION FOR GOLD CARD Rn Pe 
MAILMERGE DATABASE SYSTEM 19.95 
MEDIA MANAGER SPECIAL EDITION 49.95 
MEDIA MANAGER 24.95 
MEGA DICTIONARY 29 <95 
MICROBRIDGE 39.95 
NAMES AND ADDRESSES DATABASE SYSTEM 19:95 
PAYROLL SYSTEM 49.95 
PC UEROR GOLD SPECIAL EDITION WITH DR-DOS v6.0 179.95 
FC R GOLD SPECIAL EDITION Phe 
PC R WITH DR-DOS v6.0 139.95 
PC IR 59.95 
PEDIT PRINTER DRIVER FOR XCHANGE 19.95 
PERFECTION PLUS SPECIAL EDITION WITH SPELLCHECKER 139.95 
PERFECTION PLUS WITH SPELLCHECKER 99.95 
PERFECTION SPECIAL EDITION WORD PROCESSOR IF 99 
PERFECTION WORD PROCESSOR 59.95 
PERFECT POINTER LS 29.95 
PROFESSIONAL ASTROLOGER WITH ASTRONOMER 69.95 
PROFESSIONAL ASTROLOGER 59.95 
PROFESSIONAL ASTRONOMER 29.05 
PROFESSIONAL PUBLISHER TOOLBOXES (PARTS ONE & TWO) 49.95 
PROFESSIONAL PUBLISHER TOOLBOX PART ONE 29.95 
PROFESSIONAL PUBLISHER TOOLBOX PART TWO 29.95 
PROFESSIONAL PUBLISHER 89.95 
FLICK CARD INDEX SYSTEM 29.95 
ICK FRONT END SYSTEM 24.95 
THS MATHEMATICAL SYSTEM PART ONE 69.95 
THS MATHEMATICAL SYSTEM PART TWO 59.395 
THS MATHEMATICAL SYSTEM (PARTS ONE & TWO) 99.95 
MACHINE CODE MONITOR v2.05 39.95 
VER ARCHIVE UTILITY 19.95 
REVERSI GAME 9.95 
SEDIT + SCREENPRINT ARCHIVE UTILITIES 39.95 
SOLUTION PC EMULATOR WITH DR-DOS v6.0 109.95 
SOLUTION PC EMULATOR 29.95 
SPELLCHECKER WITH DICTIONARIES 49.95 
SUCCESS CP/M EMULATOR 49.95 
SUPERBASIC MONITOR 24.95 
SUPERFORTH COMPILER WITH REVERSI 39.95 
SUPER ASTROLOGER 24.95 
SUPER BACKGAMMON GAME 9.93 
SUPER SPRITE GENERATOR 29.95 
TOOLKIT III WITH ROM 49.95 
TOOLKIT III 29.95 
TRANSFER UTILITY SPECIAL EDITION 29.95 
TRANSFER UTILITY 9:95 
TURBO BASIC COMPILER + TOOLKIT 79,93 
ULTRAPRINT SCREEN DUMP UTILITY 19.95 
XREF SUPERBASIC PROGRAM ANALYSER 29.95 
KEY>>>»»>> Available either on cartridge or disk 
Available only on disk 
Minimum 512K exp:only available on disk 
Aas ti39 Minimum 256K exp:either cartridge or disk 
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Available only _on cartridge 
Minimum 1.5Mb RA 
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Minimum 256K exp:only available on disk 


M:only available on disk 
As well as cartridge or disk, you get a ROM 


Send to: DIGITAL PRECISION LTD, 222 THE AVENUE, CHINGFORD, LONDON E4 9SE or phone 081-527 5493 
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Bryan Davies takes a forward look at LineDesign with Plus4, and 


scans the scene. 


aving finally seen a 
recent version of 
Text87 Plus4 working 
with Linedesign, | 
realised that the enthusiastic 
reports of the user who gave 
the demonstration were clearly 
not misplaced. Hopefully, we will 
receive a copy for review before 
too long. Text87 itself has been 
changed in several ways, having 
reached version 3.9, but it looks 
essentially the same as before, 
and is still much the same size. 
The addition of Linedesign to 
the Print menu is about the only 
sign of the new-found DTP 
capability, Most of the changes 
since previous versions are to 
the basic WP functions. For 
example, the editing of the Ruler 
is now interactive, making it 
more like Quill, in this respect. 
This will be welcome to many 
users; you can see the effect 
new margins are having on the 
text The setting-up of founts for 
screen display, to match the 
printed ones, is now done on- 
screen, and is easier; you can 
use existing founts lists, too. 
Again, this is an area where 
users will have had difficulty with 
previous versions, and the new 
approach will be welcome. The 
Type can be changed several 
times from within the Block 
operation. 

Linedesign itself is massive, by 
QL standards, being supplied on 
ten 3.5-inch DD disks. ED drives 
or a hard disk drive are desir- 
able devices! There are a variety 
of detail errors in the version | 
have seen, such as faulty char- 
acters in some founts, but the 
overall presentation of the pro- 
gram seems generally user- 
friendly, and the printed results 
are very good. The instructions 
are nicely printed, and look to 
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be well laid-out The producers 
of Linedesign have come a long 
way since they sent samples of 
their early programs to QL 
World. 

Any DTP-type program relies 
heavily on the graphical capabili- 
ties of the system it is run on, 
and QL graphics are not fast 
Linedesign is quite brisk most of 
the time, when run on a Gold 
Card-equipped QL, but there 
are times when the user will 
surely wish for the graphics 
card that Miracle Systems were 
said to have been developing 
late last year, Other things - 
notably the QXL card - got in the 
way of this project, but it is now 
reported that Miracle have 
switched their attention to the 
card, having finished much of 
the development work on the 
QXL The QXL card may go 
some way towards speeding-up 
the ‘painting’ of the screen, but 
PC graphics too are decidedly 
slow, 


QSpread 


Qspread, the Pointer 
Environment spreadsheet pro- 
gram has now got to version 
1.17, and the man who writes it - 
Oliver Fink - has written to say 
he has taken note of the points 
made in the recent review con- 
cerning the user's access to the 
program. Writers of application 
programs are sometimes 
placed in a difficult situation by 
the operating system and/or 
supervisory interface through 
which their programs communi- 
cate with the computer, and this 
is certainly the case with 
QSpread. My sympathy is with 
the programmer. Whether or not 
there is something intrinsic to 
the “graphical user interface” 


concept which slows down the 
user's connection with the appli- 
cation program is a very debat- 
able point It is certainly true that 
the Windows GUI on the PC has 
this effect On the other hand, it 
is also true that it takes applica- 
tion programmers some time to 
find out ways of getting GUls to 
perform, and later version of 
programs can be appreciably 
faster than the initial ones. 


Ramdisks 


Reader Michael Hussmann, 
from Hamburg, has taken me to 
task and requested that | make 
amendments to comments 
made about ramdisks in a previ- 
ous article, but further checks 
on my QLs do not suggest the 
points made earlier were wrong. 
The reference to ramdisks 
came in connection with using 
Quill, and trying to prevent it 
commandeering all the available 
free memory. One way to 
restrain Quill would appear to 
be to format a ramdisk of suffi- 
cient size to reserve all the 
memory Quill really does not 
need, before Quill is loaded, the 
idea being that you could then 
get rid of the ramdisk, freeing 
the memory for use by other 
programs. The problem as | saw 
it was that the static ramdisk 
routines, aS were supplied with 
some interface boards, or as 
separate software, years ago 
would do the job simply, but the 
dynamic ramdisk routines which 
are now normal would not 

On a Gold Card-equipped QL, 
the DIR RAM1_ command will 
show a capacity of roughly the 
amount of memory currently not 
in use (use the TK2_EXT com- 
mand first), This ram drive is 
dynamic in the sense that the 


memory it is nominally occupy- 
ing will be given to programs, as 
they require it, so starting Quill 
results in all the spare memory 
being taken by it (all bar 4608 
bytes, according to the PRINT 
FREE_MEM command). 
Attempting to get around this 
behaviour by specifically format- 
ting a fixed-size ramdisk, got me 
nowhere either, since reducing 
the size of this ‘drive’ to zero by 
giving the command FORMAT 
RAM1_0O. after Quill had started 
left me unable to run even a 
mini-orogram, and the 
FREE“MEM figure was still 
4608 bytes. The same proce- 
dure worked quite satisfactorily 
with non-Psion programs, with 
the memory reserved by the 
ramdisk becoming available to 
any programs started subse- 
quently. 


At first sight, that was the end 
of the story but, in a subsequent 
discussion with Freddy Vachha 
of Digital Precision, he suggest- 
ed making use of the NEW 
command, before and after the 
FORMAT command, just in case 
that freed-up the memory that a 
simple FORMAT RAM1_0 had 
not It was an obvious point - 
once Freddy had reminded me 
of it - and it did the trick 
Unfortunately, it worked once, 
but nothing | did subsequently 
reproduced the same result 
The Trump Card would be likely 
to give similar results. Rather 
than spend a long time trying to 
find a fool-proof way of reserv- 
ing memory this way, it should 
be more effective to use the 
commands ALLOCATION and 
DEALLOCATE (Turbo Toolkit) 
and ALCHP, RECHP and 
CLCHP (Toolkit 2), or use Simon 
Goodwin's Taskforce, 


Minerva 


My comments about the 
Minerva rom clearly upset TF 
Services, and some clarification is 
needed. My feeling about modifi- 
cations to QDOS is not that they 
shouldnt be attempted, but that 
existing software should be taken 
into consideration from the start 
People who delved into Qdos 
and SuperBasic years ago found 
errors, and wrote programs to 
get around the errors. The QL 
has developed a lot over the 
years, without Qdos being 
touched, as witness the excellent 
collection of hardware and soft- 
ware we have now that did not 
exist a few years ago. 

A complete new operating sys- 
tem, which is what Tony Tebby is 
Said to have been working on for 
some time, is a different matter. 
No-one is better placed than 
Tony to know what needs doing 
to improve upon Qdos. 
Presumably, we have seen, and 
will see, elements of the new OS 
in the Atari and QXL hardware 
QL emulator cards, It is to be 
hoped that the new system will 
be able to run all existing, major 
software and does not produce a 
crop of complaints about incom- 
patibility to vex hardware design- 
ers and software publishers alike. 

(Next week, jousting at Windsor- 
Ed) 

And now - incidentally - another 
Satisfied Minerva customer. Geoff 
Wicks responded to comments 
made in this column about the 
use of the Minerva rom. He 
reports finding no significant 
compatibility problems when 
using his regular software (Psion 
PC-Four, Perfection SE, 
Professional Publisher, 
Conqueror SE, Eye-Q, FilEd) on a 
Minerva-equipped QL, but he has 
had some trouble using Front 
Page Extra and Flight Simulator. 
He has managed to "bodge” FPE, 
using a routine supplied with 
Minerva, but the same fix pro- 
duces “the most impressive crash 
on a QL that | have yet seen..”. 
Digital Precision's Lightning is in 
use on his QL most of the time. 

He did point out that he has a 
relatively-recent version of 
Minerva - 1.93 - and that he had 
had crashes when using a 
Trump Card in the same system, 


but is happy with the behaviour 
when a Gold Card is fitted: A cou- 
ple of his own public-domain pro- 
grams which gave trouble on a 
standard JM rom QL work fine 
with Minerva. He cites the fea- 
tures of Minerva that are of most 
advantages to him as the com- 
posing of accented characters, 
better editing with the EDIT and 
INPUT commands, and a warm 
reset which does not corrupt the 
Gold Card clock 


Readers’ Letters 


| M Gaye sent in two 35-inch 
disks, one DD and one HD. He 
could not get either of them to 
format to the full capacity, and 
asked for a second opinion on 
them. He has both DD and HD 
drives. The HD disk was no prob- 
lem - it formatted to the full capac- 
ity firsttry, on both my QL and PC. 
This suggests there is a problem 
with the HD drive Gaye used to 
format it The DD disk was anoth- 
er matter. After more than ten 
attempts, on both QL and PC, it 
gave no more than the capacity 
that Gaye had obtained from it 
Various attempts to “doctor’ it did 
not increase the capacity. This 
was not surprising, as a visual 
examination of the disk surface 
revealed a wear ring near to the 
disk centre, which was the area 
reported by software as being 
bad. Something had damaged 
the disk; either the drive 
read/write head had scraped it 
or some dirt had got in and done 
the job. As a final check, an HD 
format was attempted in an HD 
drive, and the disk was immedi- 
ately branded as being unusable 
for this. This may not seem sur- 
prising, but it is most unusual, in 
my experience. 

One thing to bear in mind 
when using drives to format disks 
of different densities is that you 
can get odd results; for example, 
one of the tests with these two 
disks produced 720/720 sectors 
from a disk that should give 
2880/2880. If you are using a 
Gold Card, make use of the com- 
mand FLP_DENSITY xX, inserting 
either D, H or E (for DD, HD or ED 
density) for X, as appropriate. This 
ensures that the interface soft- 
ware knows what the disk to be 
formatted is. 
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New Games: The Oracle (by Jochen Merz) The Oracle is an ancient tactic-puzzle, where 
you do not have to be fast but clever! You have to fill different tiles into a field, but there 
are various rules how to do it. If you can place all the tiles you a bonus - if you obeye 
special rules you get much more points. Every game is different, you'll never be bored. 
Features: high-score table, hints for the next move etc. DM 49,90 


Minefield (by Bernhard Scheffold) Another game for the Pointer Environment. You need 
skill and concentration to clear a minefield. Many options, configurable size, number of 
mines etc. Toolkit Il required. DM 39,9 


QD Version 5 - The first (and only) Editor using the PE. Dynamic memory allocation, no 
limit on numbers of lines, comfortable block-handling and many, many new features, e.g. 
ge ie menu, better search/replace, GOTO Procedure and Function, even Machine 
code label. 

New features: V5 Thing Interface which makes QD5 extendable and inbuilt Hyperlext 
HELP System! This HELP System is very easy to use, simply move the cursor over a word 
and press HELP (Fl) and you get extensive help on the subject. With complete HELP 
(German and English) for SuperBASIC, inclusive examples! It is very easy to make 
Assembler-Help, e.g. get external definition of routines, libraries etc. with one keystrokes. 
HELP can be called recursively, which means, you can get help on previous help on 
another help subject. You can even edit the help texts, add remarks, examples etc. DM 


125,- 

Upgrade from QD V4 DM 30,- 

All our products which contain SuperBASIC extensions will be updated so that they will 
have files which you add to your HELP System so that help is provided for additional 
Procedures/Functions! 


HyperHELP BASIC 

This product gives you instant help in SuperBASIC! The price is much lower for those who 
program in SuperBASIC only and do not require a full QD (although it is very useful). 
HyperHELP can be executed, put onto HOTKEY or woken from a Button. It displays the full 
set of SuperBASIC procedurs, functions and keywords currently existing in your machine, 
plus additional help on operators, identifiers etc. Simply click on the word you get the full 
description, use of all parameters plus examples. FORGET ABOUT YOUR MANUALS for 
parameter description! You get complete help on SuperBASIC, in German and English. The 
help files can be updated with any editor, Quill, Text87 so that you can update and add 
remarks whenever you want. DM 49,- 


QMenu-the Menu Extension NOW IN VERSION 4! 

QMenu is a very easy to use interface with pre-defined menus (e.g. multi-column file-select, 
simple-choice boxes, select from lists, error handling). These menus may be ‘used from 
SuperBASIC, machine code and other languages. New features: the directory name is 
(optionally) not fully listed, ie. only the names INSIDE the subdirectory are given, allowing 
for much more files to be listed in the window. New DO AND REPORT menu. Brandnew 
feature: pre-defined directories and Extensions may be changed and configured at run- 
time! More examples, improvements here and there, which makes the menu Extension 
getting mature. DM 39,90 

Update with new manual DM 16,- 


QSpread - a new Spreadsheet program. It is completely mouse- and/or keyboard- 
controllable and uses, of course, the Menu Extension. Windows may be enlarged up to the 
maximum screen area, it may be split in up to three different horizontal and vertical 
sections, giving 9 independent controllable areas. Every cell may be formatted 
independently, with many options (justification, decimal point etc.) and with preview. Sum- 
and other often-used macro-functions. Maximum: 32768 cells, where, for example, 16000 
cells need about 400kBytes. Block handling and block entry is very easy, especially if you 
have a numerical pad: you select the block and enter the values one after the other. They 
are automatically place in the right order. No cursor-key-action necessary! New cellname- 
enquiry, echo-function, different rounding methods. Many addtional functions, which 
belong to today’s standard-equipment: Help, Button-function, use of the Scrap, all 
standard file operations, calculation order row or columns etc. [V1.12] QSpread with 
comprehensive manual DM 169,- 


QDOS Reference Manual DM 89,90 QPTR DM 92,- 
SER Mouse driver DM 40,- QSUP DM 79,90 
FiFi DM 49,90 DISA DM 90, 
QShang DM 45,90 Thing & EPROM Manager DM 61,50 
LineDesign DM 249,- text87plus4 DM 239 
Diamonds DM 35,90 BrainSmasher DM 45,90 
Arcanoid DM 35,90 Firebirds DM 35,90 
SuperGamesPack DM 90,- The lonely Joker DM 52,90 
EasyPTR Part | DM 89,- Part 2 DM 49,- Part 3 DM 49,- 


QVME - Emulator card for ATARI Mega STE DM 695,- 
Harddisk-Kit for ATARI Mega STE DM 99,- 
Medium for 44MB SyQuest changeable harddisk DM 143,- 
All sorts of Quantum SCSI-harddisks at cheap prices available, 
spare ones or readily cased (with cables, adaptor etc) for ATARIs. 


Please add DM 13,- for Fag! and package (Europe) or DM 13.- for one item and 


DM 7,- for every further item (Overseas). All prices incl. 15% V.AT. (can be deducted 
for orders from non-EEC-countries). E&OE. 
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Keyboard membranes ahoy! 


If your QL's keyboard isn't behaving like its old (or young) self, we have some good news. Bill Richardson 
of EEC has negotiated a whole new batch of membranes from the manufacturers. (The membrane is the 
bit that goes under the keys, and wears out) The catch is that he had had to order a good-sized batch, so 
if you think you're going to need a new keyboard membrane in the near future, now is the time to let Bill 
know. If you aren't sure, call Bill, or Tony Firshman at TFServices, and they can, no doubt, give you some 
advice, 

The new membranes cost #10 one-off, but there are discounts for quantities over 20. 

The deal included new membranes forSpectrum models Spectrum+, Spectrum+2, =3 and 128K, so if 
you know anyone who has an ailing Spectrum, tell them the news. 

EEC's Universal Disk Drives have spawned a new, cheaper version. The Economy Universal Disk 
Drives do away will all the external DIP switches, connectors etc, that are not needed, and are suitable for 
the QL, Spectrum and PCs only. 

They come in 4MB, 2MB and 1MB capacity, You do not have to buy a pair of identical-capacity drives: 
you can mix-and match to suit your needs, and save more money. The 4MB drives cost #60 each, the 
lower-capacity drives are less. 

The fully-configurable original Universal Drives are also still available. Ask Bill for advice. 

WNRichardson & Co. (EEC), 18-21 Misbourne House, Chiltern Hill, Chalfont St. Peter, SLO QUE. 
Tel. 0753 888866; TFServices, 12 Bouverie Place, London W2 1RB. Tel. 071 724 9053. 


What no Chairs? 


Bill Richardson reports from the QL meeting held by 
IQLR at Newport, Rhode Island, USA on 5th June! 
Business was good, says Bill. His photos show 

Tony Firshman of TF Services “closetted” with his QL 
set-up in the toilet of the Motel where the UK party stayed, 
getting ready for the latest Minerva demonstrations at the 
show. We've heard of putting the QL on a pedestal, but 
this just goes to show that you can take your favourite 
computer anywhere! Let's hope Tony was on a roll.. "Feature of the meeting” was Stuart Honeyball and the 


new QXL Interface, Miracle is now IQLR's agent in the UK - a true transatlantic symbiosis. 


Pointer Programs for Mouse Maniacs 


Following last month's review of the Albin Hessler mouse interface by Bryan Davies, QL Scene draws readers’ attention to some of the range 
of programs written to run under the QJump Pointer Environment, a mouse-driven front end and management program for the QL The 
Pointer Environment itself is included with most major programs designed to run under it 

Dilwyn Jones Software (tel. 0248 354023) has an agreement with Care Electronics to market most of their QL products. Software for the 
Pointer Environment includes Qpac1, Qpac2 and Qtyp. Qpac! is a set of Pointer Environment utilities, which include as part of their number a 
pop-up calculator, calendar, alarm, typewriter utility, digital clock and Sysmon (system monitor) utility. The Pointer Environment is included, On 
disk only, for expanded memory. Qpac2 is a full file maintenance program, allowing copy, delete, view, format, bakcup, move, execute, print 
channels information, hotkey listing, jobs menu, Things menu, Sysdef utility, program-picking utility (to list programs currently running, for you to 
select - saves repeated Ctrl-Ciing). Qopac2 includes a tutorial program. Disk only, for expanded QL memory. 

Qtyp is a spelling and typing checker which can be used with most QL programs, including Quill, Also supplied as part of text87 Plus4, it 
comes with a 40000 English dictionary, plus French and German dictionaries, and a dictionary editor, A SuperBasic interface allows you to 
write Basic programs that use Qtyp. On disk for expanded memory only. 

These three programs are written by Tony Tebby, and Dilwyn Jones of DUC is happy to give advice on request 

Jochen Merz Software (010 49 203501274, Germany) has a long list of programs using the Pointer Environment Merz products usually 
come with the Extended Environment, including the latest Pointer Interface, window manager, Hotkey System || and standard CONFIG. QD and 
QSpread have a menu-driven CONFIG. The minimum requirement is usually a Qdos machine (QL or Atari ST/QL emulator), one disk drive and 
ram expansion. Most programs are Minerva-compatible, but the Thor remains a mystery. 

Merz's roster has on it QD, the Pointer Environment text editor; QSpread, the PE spreadsheet with up to 32768 cells; QSup system utilities - 
system defaults, translation table editor, notepad, printer panel, etc, Fifi, the menu-driven file finder; QDesign, a graphics program with virtual 
graphics on QL emulator and Minerva, up to 2880x2880 pixels, choice of screen/page standards, etc; Vecedit vector font editor for QDesign’s 
scalable fonts; DISA, the intelligent disassembler; DataDesign advanced database; QPTR, the programming manual for the Pointer Interface, 
with SuperBasic extensions to allow access to the facilities; EasyPTR menu-driven menu designer, and QMenu, which allows the use of the 
Menu Extension in your own Basic and machine code programs. 

Merz even do three games for the Pointer Environment Brain Smasher, QShang and The Lonely Joker. 

lf you are buying software for a mouse-driven system, check your supplier's opinion on whether the software you want will work with your 
mouse interface. With newer mice, the answer should be positive. Some people hate mice, but others become addicted. 
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Printing Sideways 
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DUC in action again - their new one is called Sidewriter, a sideways-printer utility which prints spread- 
sheets and text files sideways across the length of a sheet of paper. Sidewriter was partly inspired by a 
letter in QL World's readers’ column Open Channel, March and May 19938. ‘This program was planned 
beofre those letters in the magazine,” writes Dilwyn Jones, “but they speeded up its completion.’ 

Sidewriter takes exported or printed Abacus spreadsheet files, or any plain text file. The program can 
be either pointer driven with a mouse, or used from the keyboard without the pointer environment 
installed (for unexpanded QLs, for instance), It can be used with QSpread with a plain text filter or a file 
orintout 

Lines printed sideways can be configured at 256 characters as supplied, or even longer lines. It offers 
a choice of 68,9, or 12 lines per inch across the paper, handles paper up to 16 inches wide, and up to 
2048 characters sideways down the paper. There are 17 fonts in two sizes, and all may be printed in 


normal or condensed width, giving a choice of four character-widths in all. 

Gridlines can be printed to guide the eye along columns of figures in large spreadsheets. 

Expanded memory is required if the pointer environment is in use. The PE is supplied with the pack- 
age; if used without it, Sidewriter will run on an unexpanded QL 

Sidewriter costs £15 disk or microcassette, including UK postage. Add £1 for overseas postage. 
Order from Dilwyn Jones Computing, 41 Bro Emrys, Tal-y-bont, Bangor, Gwynedd LL57 SYT. Tel. 


0248 354023. 


CASH FLOW 


January 


February 


4080 .00 
2790 .00 


GROSS PROFIT 1290.00 


EXPENSES 
wages 7oo .0O 
adver tising 
rent 
electricity 
depreciation 





New DJC 
Catalogue 


DJC has produced the latest issue of its 
20-page catalogue, detailing a range of 
about 100 QL products, from microdrive 
cartridges to software. It includes descrip- 
tions of all items, including many brand 
new releases, as well as sections! isting 
addresses and telephone numbers for 
QL suppliers worldwide, and answering 
some commonly-asked QL questions. 
New products listed include the serial 
mouse system for the QL, Sidewriter (a 
utility for landscape printing of wide 
spreadsheets or other documents), and a 
range of software formerly published by 
CGH Services before their closure in 
March 1998. 

What Dilwyn doesn't say in his press 
release is that the catalogue contains 
dozens of good, low-cost programs, and 
a number of important less-low-cost ones 
as well. Don't overlook DUC if you are 
expanding your software base. 

Dilwyn Jones Computing, 41 Bro 
Emrys, Tal-y-bont, Bangor, Gwynedd, 
LL57 SYT. Tel. 0248 354023. 








4323.73 
2914.86 


1414.86 


4504.65 
3002 .32 


QW 
— 
= 
= 


EX-CGH ADVENTURES 


Alan Pemberton has made his popular adventure games into SQLUG-ware. 

Formerly published by CGH Services, who closed down earlier this year, the five adventures 
are on a two-disk compilation called “adventure93, Adventure Playtime, the Tower of Valagon, 
Starplod and Ye Classical-Type Adventure are on Disk 1. On Disk 2 the Voyage of the Beano 
stands alone. 

Access to SQLUG is on two levels. Adventure93 can be obtained from Qubbesoft amd 
copied as public domain so long as all the accompanying documentation is included. In addi- 
tion, users may register their SQLUGware package for a fee (in this case for £7), for which 
they receive printed manuals, a helpline service, and free upgrades when they appear. 

SQLUG (the Scottish QL Users Group) would like more people to know about their activities 
and contact them. For information or to register your SQLUGware, write to Alan Pemberton, 
SQLUG Secretary, 65 Lingerwood Road, Newtongrange, Dalkeith, Midlothian EH22 4QQ. 


ALL FORMATS DIARY 


Coming dates for the All Formats Computer Fair are: 

J25 Jul West Midlands National Motorcycle Museum, jnction 6 of the M42; August no 
dates listed; Sep West Midlands National Motorcycle Museum, jnction 6 of the M42; 12 Sep 
Brighton Corn Exchange, Church St, Brighton 18 Sep Leicester De Montfort Hall, Granville St, 
Leicester. 

Check with suppliers whether they will be at a particular Fair. If you have far to travel phone 
All Formats 0608 663820 to check arrangements haven't changed. 

Day tickets are £4; attendees can get up to 50 £1-off vouchers by sending an SAE to the 
organisers at Maple Leaf, Stretton-on-Fosse, Moreton-in March, Gloucestershire GL56 
9QX. (Only one voucher per ticket) Photocopies of these vouchers are also accepted. 
Admission to the Fairs is a flat £2 between 2pm and 4pm (£1-off vouchers do not apply at 
these times). 
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Guernsey calling 


| had a response from a man 
in Guernsey to the letter you 
published in the March issue. 
Over the ‘phone he said he had 
thought he was the only QL 
user in Guernsey until he read 
my letter in the magazine. . 

After talking with him, | started 
thinking more about hte future 
of my two QLs and my two 
Psion Organisers, and totted 
up all that | have spend on them. 
My thinking was, before the con- 
versation, that the amount of 
money needed to improve my 
QL and Organisers would be 
spent more sensibly on an 
obsolescent and therefore 
cheaper 386 and a Psion series 
3. However, this would mean all | 
had spent (and done) previously 
would be wasted. 

Now, though, if | decide to 
spend money on upgrading, | 
will improve my QL D16 with a 
Gold Card and two ED disk dri- 
ves. My QL D11 will be 
improved, one day, to be more 
like a D16 (| started on it about 
three years ago!) The 
Organisers are being improved 
with 2*256K Flash ram packs. 
And | will continue to improve in 
my use of things | have learnt a 
little about over the last seven 
years instead of having to start 
again with a new set of conun- 
drums like | had to when chang- 
ing, after eight years, from one of 
the early American 8K PETs, 
later expanded to 32K! 

| have bought a book which | 
hope will enable me to learn 
how to communicate better 
between the QL and the 
Organiser, Perhaps | will learn 
how to use the Tandata commu- 
nications unit more effectively 
with the QL | retire, at least par- 
tially, next year, SO | should have 
more time. 

Lawrence Carpenter 
Guernsey 
Channel Is. 


Bug fixes 


May | also correct an impres- 
sion? The incompatibility prob- 
lem mentioned by Tony 
Firshman in last month’s Open 
Channel! was referred to me by 
another user, and has since 
been confirmed. It has apparent 
ly been cleared up, as | have not 
had any further reports. What | 
said to Tony, in the discussion 
he mentioned, was that | did not 
remember the details at that 
time (in the middle of a Quanta 
meeting), but there was no prob- 
lem about checking it 

We have seen something of a 
new operating system in the 
Atari QL emulator, and now in 
the QXL card, and both of them 
are, to me, welcome develop- 
ments. However, if any new OS 
causes significant problems with 
existing software, it will receive 
complaints from users, and 
some complaints are likely to be 
passed to me. 

Bryan F Davies 
Kent 


| read with interest the review 
in Vol. Il No. 5 of QL World of 
QMaths. As | am the author of 
one of the programs on the 
QMaths disk, Q-Fract, | gave 
particular attention to this part of 
the review, and | would like to 
thank the author for bringing to 
my attention a couple of small 
problems in 10.6, both of which 
| have corrected in 1.07. 

The first problem required me 
to borrow a QL with an old 
“slow” memory expansion, as | 
have a Gold Card system. | 
could not help but agree with 
the reviewer that the old stan- 
dard directory routine was a bit 
slow, so | have rewritten it The 
new version is about five times 
faster on most systems, and so 
should be crisp enough to keep 
most users happy. 

The second problem, inexplic- 
able error messages, was more 
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awkward, as it only Occurred 
with Minerva systems, and | had 
difficulty gaining access to such 
a system to do testing. The 
result was that | found that the 
fault in the Minerva, which 
sometimes does strange things 
when comparing strings. In spite 
of this, | altered my program so 
that the offending errors should 
no longer occur, 

| would like to take this oppor- 
tunity to make a plea, both to 
Minerva users and to author 
Lawrence Reeves. When a pro- 
gram does not work properly on 
systems fitted with a Minerva 
rom, | should like to know that a 
process such as the following 
takes place: 

The author of the malfunction- 
ing program checks it for bugs, 
and corrects any found. The 
Minerva programmer also 


checks his code for bugs which - 


(since he is human) it may well 
contain, and if the fault lies with 
Minerva, it can be corrected in 
the Minerva source code. 
Communication may sometimes 
be called for between the pro- 
grammer and other software 
authors, and both parties should 
be willing if need be to establish 
contact 

Unfortunately, this is not what 
often happens. Almost every 
time a program misbehaves on 
a Minerva system, the assump- 
tion is that Minerva cannot be at 
fault. This is frankly unlikely as, 
brilliant though he is, Lawrence 
too must make mistakes. My 
contact with QL users and soft- 
ware authors suggests that 
many (possibly most) of the 
problems are not even brought 
to Lawrence's attention, since 
users assume that Minerva can- 
not be to blame. If Minerva is to 
evolve harmoniously, this must 
change, and where a program 
misbehaves only on Minerva 
systems both the author of the 
program and the author of 
Minerva may have work to do. 

When | examined the prop- 
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lems indentified by your review- 
er, | was able to correct my 
code within a few hours. 
Lawrence Reeves is certainly a 
better programmer than | am, 
but for goodness’ sake give the 
man a chance! If a package 
won't work properly on your 
Minerva system, report the prob- 
lem in detail to your Minerva 
supplier as well as to the suppli- 
er of the other program. That 
way is the greatest likelinood 
that it will be put right wherever 
possible. 
Mark Knight 
Notting Hill 
London 


It's funny how these things 
suddenly sit up again after years 
of quiet isnt it? Is it the weather? 
There’s no doubt that when 
Minerva first appeared, some 
adherents took an aggressive 
attitude towards anyone who 
denied that Minerva was the 
One True Rom. This more than 
anything else created the 
‘Minerva question’, which need 
otherwise never have existed. 
Oddly, | never received a rea- 
soned defence of the position 
from any user, although we dis- 
cussed it a good deal internally, 
having both the supportive and 
the sceptical on our team. 
Eventually after some correspon- 
dence the QView team them- 
selves offered us an article on 
Minerva’s rationale and history, 
and | eagerly accepted, but it 
never came to fruition. 

In the intervening years, more 
usefully, work has been done 
both on Minerva and on other 
software to improve inter-rela- 
tionships. However, | think that 
Mark is basically right and that it 
is still widely assumed that 
Minerva is either intrinsically right 
or intrinsically intractible. Neither 
of which is true. If you have what 
looks like an incompatibility 
problem, talk to both publishers. 
And let the best man refrain 
from treating differences as Sins. 


Speccy Basic 


The following information 
might be of interest to some of 
your correspondents. Spectrum 
Basic is a superset of ZX80/81 
Basic. In other words, the two 
are alike, but the Spectrum ver- 
sion contains extra commands 
for colour, sound and graphics, 
plus a hook code for paging the 
Intgerface 1 shadow rom when 
any of its routines are invoked. 
Although QL SuperBasic con- 
tains functions and procedures 
that would be familiar to 
Spectrum users, there are a 
number of differences. It was 
written from scratch, ie the actu- 
al code is not derived from 
another product; the single-key 
command entry system was not 
implemented, and the file-han- 
dling commands use a totally 
different syntax. For example, in 
Spectrum Basic: 


LOAD *"M"1;;MYPROG" 


In SuperBasic: 


Faint cursor 





For nearly eight years, my 
trusty old QL has given me first 
class service. Problems have 
been few and have generally 
been sorted out by reference to 
my collection of QL Worlds, 
books or by harassing a com- 
puter whiz-kid friend of mine. 
Recently, however, | have come 
across something which | 
havent been able to solve and 
would be grateful for tips. 

My Microvitec Cub monitor 
has been a bit wobbly (an inter- 
nal fuse blew, which | replaced. 
Then several months later the 
sides of the image on the 
screen started to bow inwards). 
At the moment | can't afford to 
have it looked at, so | am using 
a Philips amber screen mono- 
chrome monitor. The program | 
use, almost exclusively is The 
Editor Special Edition, and the 
problem is that, although the 
Paper and Ink colours can be 
readily set to give good contrast 
on a black-and-white screen, 
there does not seem to be any 































LOAD MDV1_MYPROG 


Tony Tebby, being the sensi- 
ble fellow that he is, decided that 
he wouldnt subject QL users to 
the vile, sadistic and brutal form 
of torture known by PO, ST and 
Amiga owners as the Command 
Line Interface. To put it another 
way, you have to communicate 
with QDOS via machine code or 
a high-level programming -lan- 
guage - which is one of the rea- 
sons why SuperBasic ws con- 
structed as a distinct and sepa- 
rate entity. 

You can turn your monitor into 
a tropical fish tank by purchas- 
ing Screen Dazzler, a wonder- 
ful new product from Dilwyn 
Jones Computing. However, 
strongly advised that you do not 
pour water or fish food into your 
display, since neither material is 
QDOS- (or electricity-) compati- 
ble, 


K J Brickwood 
Stockwell 
London 


way to change the colour (or 
character) of the cursor, which 
is very faint. 
| assume that the cursor in 
the program is the standard QL 
cursor, Looking at my reference 
books on Qdos by Colin Opie, 
Andrew Pennell, Jan Jones, etc, 
it is apparent that, while there 
are routines to toggle the cur- 
sor on and off, move it up and 
down and position it on the 
screen, there does not seem to 
be any way of altering the 
colour or shape of it Please put 
me out of my misery: can it be 
done or can't it? 
Gwynne Owen-Smith 
Ashford 
Kent 


Freddie Vaccha of Digital 
Precision, publishers of The 
Editor, answers: “Cursor parame- 
ters are not changeable on a 
Sinclair QL, unfortunately. For 
example, cursor colour is always 
the XOR of the underlying strip 
colour (so red gives black, white 
gives green, etuc.). There is a 
way to edit the cursor, but alas 

























FETT RATT 
Editor’s notebook 


There’s been a bit of sniping about magazines, 
reviews and advertisers elsewhere In the QL press 
(who no doubt feel, as we do, that they must represent 
thelr readers’ views). Leaving aside any slur on the 
people who write about the QL, and the question of 
whether any “expert” on the face of this earth could 
provide enough Information to compensate entirely for 
everyone else’s inexperience (In 20 years | have never 
yet found one. Computers. Origami. Car maintenance. 
Cookery. They all require some suffering for your art) 
Leaving all that aside: Whereas It’s true that some pub- 
lications (like QL World) depend on some advertising, It 
Is always possible to publish a magazine without any 
advertising at all. What It Is really not possible to pub- 
lish without - by definition - Is readers. 

Are any of us - magazine, publishers, advertisers - 
really going to mess you about that much? OK, we may 
be human, but think about It! 

rll be looking quite soon for a regular user to review 
the new DJC printing utility Sidewriter for QL World, at 
our usual rates. Do we have any volunteers? 











only on Minerva QLs.” (Which 
involve something of a change 
of QL culture) “Hermes, from the 
same stable, is eminently rec- 
ommendablie, but doesnt help 
with cursors.” 


Thanks to Dilwyn Jones of 
DJC, we have some more 
addresses which will be useful 
to Sinclair Z88 users. Dilwyn 
writes: 


‘To help Jean-Yves Rouffiac 
with his dead Z88, here are 
some adverts by companies 
who still support the 288, includ- 
ing the current address of the 
Z88 User Group. He should be 
able to find someone who can 
repair the machine for him. 

‘He may also like to know that 
there are at least two utilities for 
connecting a Z88 and a QL wa 
a simple cable link. One was 
called QZ and thought it is not 
advertised now might be avail- 
able from second-hand QL 
traders, the other was written by 
Phil Borman and is to be found 
in the Quanta Library and possi- 








ble from the Z88 User Group 
too,” 

Z88 Eprom magazine, mem- 
bership, and Spares Service 
(members only); also deals in 
Personal Organiser printer 
paper, ram upgrades (se/f-fit); 
Version 4 rom: Roy Woodward 
Z88 Users’ Club, PO Box 15, 
Beloer, Cerbyshire DE56 OXE. 
Answerohone/fax 0773 828707. 
(Club enquires with SAE please) 


Club software library: lan 
Braby, Thé Software Library, 
Z88 Users Club, PO Box 210, 
Woking, Surrey GU21 1ZX. (All 
software enquiries to that 
address, with SAE) 


Z88s and supplies 


Ranger Computers Ltd., 
Ranger House, 2 Meeting Lane, 
Duston, Northampton NN5 6JG. 
Tel. 0604 589200. 


HiTek Marketing, /2 
Longmoor Lane, Breaston, 
Derby DE72 3BB. Tel. 0332 
873987. 
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HARDWARE 


Care Electronics 

0923 672102 

Tebby connection but no longer dealing 
directly. 


CL Systems 
081 459 1351 
Real Time Digitizer 


Computer Technik 

(Jurgen Falkenburg) 

010 49 7231 81058 

(Germany) 

Hard disk interface, hard disk systems, 
tower housings for QL systems. 


Dilwyn Jones Computing 
(DUC) 

0248 354023 

Process controller, Power regularot, 
network prover. 


Miracle Systems 

0904 423986 

Gold Card expansion card; disk adapter; 
Extra High Density disk drives; Centronics 
adapter/lead; ED disks. 


Qubbesoft PD 

0376 347852 

Miracle Trump Card, Expanderam, twin 
3.5in disk drives. Sales and support. 


W N Richardson (EEC) 

0753 888866 

Complete QL systems, monitors, 
keyboards and interfaces, disk drives and 
printers, peripherals. 


TF Services 

071 724 9053 

Hermes IPC, Minerva rom, keyboard 
membrane, repairs, spares. 


SERVICES 


Adman Services 

(Dennis Briggs) 

0952 255895 

Spares, repairs, support, peripherals. 


Joe Atkinson 
36 Ranelagh Rd., London W5 5RJ 
Roms, mdvs, all spares. 


Suredata 
081 902 5218 
Repairs 


QL World 

(Readers’ Services) 

Subscriptions, binders, recent backissues. 
0993 811181 

Ask for Fran. 


Quanta 

General Secretary: 

Ron Dunnett 

0376 347852 

User group, support, library. 


SOFTWARE 


Athene Consultants 
0705 511439 


ARK Distribution 
0983 79496 
Archivist, Master Spy, Spy. 


CGH Services 

(Richard Alexander) 

0559384 574 

Adventures, public domain, DIY Toolkit. 
(Closing for business 31 March 1993 - 
enquiries about past products only) 


COWO Electronic 

010 41 45 211478 

(Switzerland) 

QTop, Atari QL emulator, Thor support 


Deltasoft 
7 Tyrell Way, Stoke Gifford, Bristol. 
FlightDeck, Image D, AMD Airplan 


Digital Precision 

081 527 5493 

Perfection, PC Conqueror, Lightning, 
Professional Publisher, Eye-Q, Solution, 
spellchecker, The Editor, Media Manager, 
Professional Astrologer, QMaths, CPort, and 
others. 


DJW Software 
0256 881701 
Homebanker 


Dilwyn Jones Computing 


- (DUC) 


0248 354023 

Discover, Textidy, QL-PC Fileserver, Fleet 
Tactical Command, Basic Reporter, 
QLiberator, Filemaster, The Gopher, The 
Painter, Flashback, DataDesign, QPAC2 and 
other Pointer Environment programs, others. 


Di-Ren 

081 291 3751 

Fleet Tactical Command 
(Dist. by Dilwyn Jones) 


Ergon Developments 

(Davide Santachiara) 

010 39 342 492323 

(Italy) 

ZM-X ZX Spectrum emulator, Open World, 
other QL sofware. 


Jochen Merz Software 

010 49 203501274 

(Germany) | 
QL/Atari emulators, QSpread, File Finder, 
QPTR Pointer Environment Toolkit and 
other PE programs, QDesign 2, various 
games, and others. 


Lear Data Systems 

6 Southview Green, Bentley, lpswich, 
SUffolk IP9 2DR, 

PCB-CAD 


Liberation Software 

081 546 7795 

QLib Basic compiler and utilities. 
(Dist. by Dilwyn Jones) 


Pointer Products 
0258 455117 
Pointer Environment programs 


Progs (Van Auwera) 

010 32 16 48 8952 

(Belgium) 

The Painter, The Clipart, DataDesign, 
QRactal, and others 

(Dist. by Dilwyn Jones) 


Qubbesoft PD 

0376 347852 

QL Home Finance, Public Domain 
software. 


SD Microsystems 

0462 422897 

General Ledger, Small Traders’ 
Pack/Invoicer and Stock Accounting. 
Other business software. 


SJPD Software 
0282 51854 
Public Domain software 


Software 87 
33 Savernake Road, London NW3 2JU. 
Text87 Plus4 


TF Services 

071 724 9053 

Qualsoft QL Terminal Emulator, File 
Transfer. 


WD Software 
0534 81392 


Notes: 

Addresses are only given where there is 
no business line, For Fax numbers, 
phone dealer or check ad. in QL World. 
Only larger dealers have Fax, often on 
the same number. Some numbers no 
longer active in the QL world are given 
for reference and support queries. 


Italy Show 


Don't forget the 5th Italian QL Meeting - organised by Ergon 
Development and the Qltaly club - in Reggio Emilia on Sunday 26 
September 1993. Early information can be obtained from Davide 
Santachiara on +389 522 70409 or Eros Forenzi on +39 342 
492323. 


OL-l10-Card For 
Control Applications 


from Jurgen Falkenburg of JFC Computer Technik 

Following encouragement by some customers last winter we 
decided to bring out a completely new QL product the first profes- 
sional and multifunctional inout/outputboard for the QL, the intelli- 
gent I/O card. 

The llO-Card is a standard expansion board for the QL system 
bus. It is free addressable inside the complete QL rom memory, and 
Gold Card compatible. There are almost no restrictions to its appli- 
cations to allow any QL to communicate with its environment in 
terms of measurements and controls. With a high-speed A/D (8-bit, 
2 microseconds) and D/A converter (8-bit, 1 microsecond) and 32 
digital input/output lines, many connections are possible. With the 
included Basic toolkit, all 1/O functions may be performed comfort- 
ably. 


Co-processor 


The extra add-on is the integrated 24- 
MHz 8051 co-processor. The !lIO-Card |/O 
functions may be controlled from the QL 
itself (with the on-board toolkit) or from the 
co-processor. It is controlled with a single 
further command of the QL-toolkit, and has 
lots of pre-programmed functions. With 
many applications the QL remains com- 
pletely free for system control and as a 
constantly-available user interface. You can 
even do word-processing or programming 
work, while the lIO-Card performs compli- 
cated controls. 

Five of the digital I/O lines may be used 
for special applications: two counter/timers, 
a serial interface and external co-proces- 
sor interrupt A special register is used for 
control of and command transfer to the 
co-processor from the QL The 8057 is installed with 82K rom and 
32K ram. The dual-port ram may be accessed from the QL in 
pages of 8K. In this way, amounts of data up to 32K may be trans- 
ferred easily between the processors. For special applications 8051 
programs may downloaded from the QL into the ram and called 
there. Very flexible and powerful I/O applications can be realised. 

Those who are able to program the easy-to-learn 8051 assem- 
bler may perform solutions for special applications. The QL will 
remain free for system control and constant user input After the 
straightforward testing of your 8051 code in ram, the software may 
be transferred in the free memory of the 8051 eprom. 


Applications 


The range of applications for the !IO-Card is nearly unlimited: 
scanner, sound-sampler, voltmeter, measurement of any sensor sig- 
nals such as temperature, brightness, pressure, humidity, distance, 
rotation, speed, etc, measurement amplifier, delay- and echo-gener- 
ator, digital storage oscilloscope, counter, timer, free programmable 








analogue in 


analogue out # 





frequency generator (up to 1MHz), free programmable square gen- 
erator (32-channel, 200kHz or 8-channel 1 MHz), logic analyser 
with up to 32K memory depth (B2-channel 200kHz, 8-channel 1 
MHz), interfaces with up to 32 signal lines like centronics, RS232, 
IEEE-488, SCSI, |2C-bus, Midi etc, contro! of up to 32 relays or 8 
bipolar stepping motors, model train control, round-counter and 
speedometer for 16-lane racing car model, traffic-lignt control for a © 
little town, and so on. 

lf you want to control the production line of a car manufacturer, 
for instance, no problem: beside ram expansion, floppy and hard 
disk, up to 16 IlO-Cards may be plugged into a standard QL if it is 
supplied with a special bus driver and power supply. With 128 step- 
ping motors, many movements may be controlled. If this does not 
suffice, simply install a QL-network. Due to the multitasking abilities 
of the QL, even the software for such an application may be devel- 
oped with modest effort 

With the circuit suggestions in the manual, individual peripherals 
(relay driver, motor driver, amplifier, etc.) can be assembled even by 
those who are not highly skilled in electronics. Ready to-use acces- 
sories will become available soon, as well as the proven peripherals 
of our A/D-product series. 


Introductory price 


As comparable boards for IBM- or industrial computers in indus- 
trial versions come at industrial prices (£1000 and upwards) we are 


QL-Eprom 
QL/8051 RAM 


eae EES peaaisreteseer S 


8051 Eprom ~ adUress selector 


8051 processor BUS-connector 


trying, with a presentation offer of about £160, to encourage a great 
number of users to look at modern computer control. The populari- 
ty of the first series of the lIO-Card will determine the quantity and 
price of possible following series. 

As always in the past, with the llO-Card we tried to develop an 
innovative product expanding the QL's horizons. We hope that the 
simple QL and ||O-Card handling will give an entry into computer- 
controlled measurement and control applications to the less experi- 
enced, For specialists, the llO-Card will fill this gap in the QL els 
erals product range for the first time. 


Suppliers: JFC Computer Technik, Thanweg 36, D-75236 
Ersingen. Tel. +49 7231 81058 

UK distributor: W.N. Richard-son & Co, 18-21 Misbourne 
House, Chiltern Hill, Chalfont St. Pai SLO QUE, Tel. 0753 
888866. 


The llO-Card will be available from July. The starting offer will be 
DM 899 (inc. VAT) all over the EC, plus postage of DM 20. 
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Hardy Hints 





Seconds out 


With reference to the Clock 
Quirk mentioned by Bryan 
Davies in: Troubleshooter, 
November 1992: the QL clock 
starts at 1961 Jan 01 000000, 
and goes on until 2097 Feb 06 
06:28:15, and you can SDATE 
any time between these limits. 
Calulations are done in 
seconds, starting DATES(0), ie 
Jan 1 1961, and the limit is the 
largest number (of seconds) that 
can be stored in 32 bits. The 
way in which very large 
numbers are stored in twos- 
complemented form is 
explained on page 4 of Andrews 
Pennell's Assembly Language 
Programming on the Sinclair QL 

The “quirk” occurs after 2029 
Jan 19 03:14:07, where Date = 
2147483647 (seconds). When 
DATE reaches a higher number 
than this, the Function returns 
the number of seconds - 
2147483648. The following 
SuperBasic lines, instead of 
those given by Bryan, will show 
DATES and DATES(DATE) as the 
same up to 2090, and if you 
care to continue STEP 1 instead 
of 10, you can go up to the 
clock's limit, 2097 Feb 06 
06:28:15, After that, you get back 
to DATES(0). 









interested in dates up to 2097, 
many historians may be 
interested in dates before 1961. | 
came up against these 
limitations of the QL clock most 
recently in writing a program 
which prints out a tabular 


While not many people will be 


calendar for any year. For 
anyone interested in dates 
outside the clock’'s range, | 
enclose a listing for a DOW. 
FUNCTION, which returns the 
Day Of Week for any date as a 
number 0 to 6, where O=Sunday. 
This is, of course, for our present 
(Gregorian) callendar, but it can 
easily be adapted to work for the 








































G Jackson, Whitby, N 
Yorkshire 


Long Words 


Regarding the “Clock Quirk’ 
comments in Troubleshooter 
November 1992 and February 
1993, in the QL the time (in 
seconds) is stored in the clock 
port register (PC_CLOCk) 
located at address $18000 
(D98304). This register is a Long 
Word (82 bits) and the time is 
stored as an un-signed Long 
Word Integer. This will allow a 


Perennial solutions to perennial problems. if you have any favourites, please send them in. 


maximum time (relative to 1961 
Jan 01:00:00:00) of 2097 Feb 
06:06:28:15. This equals (2 to 
the 32nd)-1, or 4,294,967,295 
seconds. However, different 
protions of the date/time from 
1961 Jan 01:00:00:00 to 2097 
Feb 06:06:28:15. 

The SuperBasic SDATE and 
simple DATES commands 
(without any numeric 
parameters) treat this number as 
an un=signed Long Word 
Integer of 32 bits. This will allow 
for the clock to be set using 
SDATE, or read using PRINT 
DATES, to any date/time from 
1961 Jan 01:00:00:00 to 2097 
06:06:28:15. 

The PEEK_L command treats 
the value in PC-CLOCK as a 
signed Long Word Integer. In 
this case, bits 0 to 30 indicate 
the value, and bit 31 (the MSB) 
indicates the sign. When bit 31 


is not set, the number is positive, 


and when bit 31 is set, it is 
negative. This gives a range of 
values from -2 to the 31st 
(2147,483,648) to +(2 to the 
32nd)-1 (2,147,483,647), 


Therefore, until 2029 Jan 


19:03:14:07 PRINT 
PEEK_L(98304) will return an 
increasing positive floating point 
value. After this time, PRINT 
PEEK_L(98408) will return a 
diminishing negative value. 


ALthough PC_CLOCK may be 
read with PEEK_L, no attempt to 
alter the value of its contents 
with the POKE_L command 
should be made. This will only 
zero the contents of the register. 
Only the correct commands 
should be used to alter the 
contents of PC_CLOCK. 

The PRINT DATE command 
treats the value in PC_CLOCK 
as an un-signed 31-bit Long 
Word. It disregards bit 31 (the 
sign bit) and returns the value in 
the lower 31 bits. It will only 
respond to numbers in the 
range 0 to +(2 to the 31st -1). It 
completely disregards the sign 
bit (bit 31). Therefore after 2029 
Jan 19:03:1 4:07, it will start 
again from 0 (1961 Jan 
01:00:00:00). 

So, provided the time is set 
correctly, PRINT DATES will 
return the correct time until 2097 
Feb 06:06:28:15. But, PRINT 
DATES(DATE) will only retum the 
correct date up to 2029 Jan 
19:03:14:07. After this time, it will 
start returning the date from 
1961 Jan 19:03:14:07 onwards. 

The following SuperBasic 
listings illustrate the above 
points: 


P Hutley, Dewsbury, 
West Yorkshire 









MIRACLE SYSTEMS 












16MHZ 68000 
HIGH SPEED 
PROCESSOR 


2M BYTE 
RAM 


CUSTOM 
LOGIC 
CHIP 


DD, HD, ED, 
DISK 


INTERFACE 





BATTERY 
BACKED 
CLOCK 


: REARAAS SBR OH 


QL GOLD CARD 


£225 inc. (£200 outside EC) 


This is the expansion that has been revolutionising the QL. It is very easy to fit - 
it simply plugs into the expansion port at the left hand of the QL - and once fitted 
it will instantly increase the execution speed of the OL by about 4 times due to 
the presence of a 16MHz 68000 on board. There is 2M of fast 16 bit RAM of 
which QDOS sees a contiguous 1920K. The remainder is used for shadowing 
the QL’s ROM and display memory and for the GOLD CARD's own code. 


There is a disk interface which can access 3 mechanisms (4 with the DISK 
ADAPTER) of 3 different densities, DD (double density, 720K), HD (high density, 
1.44M) and ED (extra high density, 3.2M) in any mix. The disk interface 
connector is the same type that was fitted to the TRUMP CARD so most QL 
compatible disk drives can be used. Please note that DD drives still give a 
capacity of 720K per diskette. Our DUAL ED DISK DRIVE allows the GOLD 
CARD to access DD, HD and ED diskettes. 


Another feature is the battery backed clock. When the QL is switched on the 
contents of the clock are copied into the QL's clock so that the time and date are 
correct. The firmware in the ROM gives the GOLD CARD all the functionality of 
the TRUMP CARD like TOOLKIT II and there is a sub-directory system for 
floppy and RAM disks. 


Physically the GOLD CARD is about half the size of the TRUMP CARD and so 

fits almost all within the QL. Its current consumption is well under the allowable 

maximum so no special power supply is required. The GOLD CARD comes with 
a 14 day money back guarantee and a 2 year warranty. 





See the QXL at: 


Saturday 4 September 1993 
Georgian House Hotel 


Manchester Road 
Blackrod, nr. BOLTON 


Sunday 19 September 1993 
Village Hall 
Gore Road 
Rayne, Braintree, ESSEX 


THE QXL 








The QXL turns the common PC into a QL compatible. The package comprises a half 
card that plugs into an 8 or 16 bit standard ISA slot and a diskette loaded with a QDOS 
compatible operating system and a Superbasic compatible interpreter. After installation 

simply type QXL and the PC will appear to be a QL allowing QL programs to be run from 
QL format diskettes. 


The card itself has a 32 bit 68EC040 processor running at 20MHz which gives a good 
turn of speed. This processor has access to its own RAM and so performance is virtually 
independent of the host PC whether it has an 8088 or a Pentium. In fact the PC is used 
purely as an I/O system giving QL programs access to the PC’s floppy disc, hard disc, 
keyboard, display, serial and parallel ports. The card itself has QL style network ports to 
allow connection to a QL network. The minimum PC specification required is an XT with 
EGA display and a spare standard slot. 


Varying RAM sizes from 1M up to 8M can be supplied. The smaller capacities can be 
upgraded to the larger ones and the cost is simply the price difference. Not all the RAM 
is available to the user programs; the 1M equates roughly with a TRUMP CARD QL 
memory size and the 2M with a GOLD CARD QL. 


During the lifetime of the QXL we intend to enhance the software to make use of the new 
hardware facilities of the PC such as SVGA graphics. As has been our policy with the 
TRUMP CARD and GOLD CARD we intend to provide software upgrades free of charge. 


QXL prices 


IM £295 (£255) 
2M £325 (£280) 
5M £410 (£355) 
SM £495 (£430) 


(prices in brackets for outside EC) 








INTERNATIONAL QL REPORT (IQLR) is a regular magazine that all QL 
users should read. It has articles for the beginner, the advanced user and 
every one else in between. Also, the international flavour combined with 
low advertising rates makes it probably the best place to locate QL related 
items. IQLR is run by QL enthusiasts whose proud boast is that they have 
never been late with an issue. If you do not already get it then ‘phone us 
now. One year’s subscription for 6 issues to any European address is 

£22.00 and it’s worth every penny. Subscribers 


elsewhere should contact SeaCoast Services, eae 
15 Kilburn Court, Newport, RI 02840, U.S.A. direct. a, Co 


Tel: (0904) 423986 [~~ To: MIRACLE SYSTEMS Ltd, 25 Broughton Way, 


To place an order by phone 
please have your credit card 
ready. For overseas customers 
we charge the prices shown in 
brackets. 


To order by post, please fill in 
the form opposite or write to 
us quoting your credit card 
number and expiry date, or 
enclosing a cheque payable to 
MIRACLE SYSTEMS Ltd. 


Please send me 


Name 


Address 


Osbaldwick, York, YO1 3BG, U.K. Tel: (0904) 423986 





| enclose a cheque to the value of: £ 


Or debit credit card Ler a Poe ere Py TL lh lath 
Expires [het hie The 


Signature 











Version 2 


Fleet Tactical 
Command — 








Alan McTavish longs for a life afloat 


INFORMATION 


Program: Fleet /actical 
Command Version 2 


Supplier: D/C, 47 Bro Emrys 
Tal-Y-Bont Bangor, Gwynedd 
LL57 8YT. Tel 0248 354023 


Prices: QL version now £39.95; 
PC version £49.95; PC/QL com- 
bined package £75.95 (serial link 
not included), 


doubt many 


QL World 
readers are 
already famil- 


iar with Fleet Tactical 
Command. For those who are 
not, | will recap briefly (| should 
point out that it is impossible to 
do justice to this program in a 
short overview). 

FTC is a real-time naval 
wargame simulator. The pro- 
gram can be used on one or 
two QLs linked via serial/net- 
work options, Each player com- 
mands a fleet of 16 assorted 
war and supply ships. Each ship 
has to be individually controlled 
by the player either being “on’ it, 
or sending signals to it You can 
move from ship to ship quite 
easily. 

The scenarios set in a 
1000x1000 mile area within 





which there are ports and natur- 


al hazards, 
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Notes: 


illustrated on this 
chart in Nautical 


100x100 miles. 


Depths are 
quoted in Metres 
at Mean Low 
Water, and are 
shown on their 
relevant contour 


representing an 
8 metre depth at 


would represent 
an actual depth 
of water of 14 


“Gulf Streams” 


general direction 
of flow thus: 


1,Skn —> 


and are quoted 
in average Knots 
of flow, as 
measured on the 
surface. 


Jetties are 
illusérated thus: 





Bridge view 


A lot of thought has obviously 
gone into the display which is 
divided into three distinct sec- 
tions. At the top is a line of digital 
information such as echo 
sounder readouts, fuel, capability 
readouts, etc. Underneath this is 
the bridge window that allows a 
view from any angle of 180 
degrees. If any of you own the 
enemy ships are within range 
they are displayed in a wire- 
frame 3D image (QL version) 
upon an animated sea. 

Below the bridge window is 





00 
Medusa South West 


the command input console, 
tactical radar display, ship's IFF 
computer, and other useful 
instrumentation. 

The makers of FTC, Di-Ren, 
have justly claimed to have 
made the program as realistic 
as possible, The ships, for 
instance, move in a manner 
consistent with their bulk and 
weight The manuals include a 
section devoted to navigation for 
which purpose charts and 
geometry sets are provided. 
Tide flows, levels and natural 
hazards have to be taken into 
account when plotting courses. 

Ships have all sorts of com- 


SSBssSo 
8 


- 


East 


partments and machinery fitted. 
The manuals contain a wealth of 
information including, for 
instance, a ship's wiring diagram. 
Machinery is of course liable to 
break down or can be dam- 
aged during an engagement 
Compartments are likely to be 
affected by flooding and fires, 
problems that all require solving, 


More thana 
game 


FTC is stuffed with details and 
is, to the best of my Knowledge, 
unique. | am not normally a 


computer games player, confin- 
ing that sort of activity to chess 
or card games, but FTC is 
something different One big 
problem with the program is its 
addictive nature, something is 
always happening that requires 
your attention! 

| first purchased FTC after its 
original review by Bryan Davies 
a couple of years ago. At that 
time program development was 
continuous and a number of 
upgrades were received from 
the developers, each providing 
new features and a more fasci- 
nating game. 

Eventually version 2 became 
available. This upgrade con- 
tained several major improve- 
ments over version one. Di-ren 
obviously made a conscious 
decision to remove some of the 
‘frills’ and concentrate on more 
useful features. Gone, for 
instance, were the nuclear mis- 


siles, and in came a much-neecd- 


ed towing option. The crew 
became part of the manage- 


ment resource situation. One 
could take on crew at their 
home ports and even transfer 
crew from ship to ship while 
under why. Given the right cir- 
cumstances, survivors could be 
rescued, The command input 
parser was improved to accept 
multiple commands and abbre- 
viations. 


Improvements 


By far the greatest improve- 
ment was a general tightening 
up on the scenario. In version 1 
you had to enforce a total exclu- 
sion zone by tracking and dis- 
abling the enemy fleet This 
could be a somewhat tedious 
business. Version 2, however, 
forces opponents to use the 
same neutral ports thereby 
ensuring contact is made. Also, 
instead of being effectively 
locked out of the game for sev- 
eral hours (game time) for viola- 


QUANTA 


tasderegndhent QL/Thor Users Group 


Worldwide Membership is by subscription 
only, and offers the following benefits: 
Monthly Newsletter — up to 40 pages 

Massive Software Library — mostly FREE! 

Free Helpline and Workshops 

Regional Sub-Groups. One near you? 

Advice on Software & Hardware problems 
Discounts from most major suppliers 
Subscription just £14 for UK members 

Overseas subscription £17 


Barclaycard: Visa: Access: Mastercard 


* Now in our NINTH successful year * 


Further details from the Membership Secretary 


Bill Newell 


213 Manor Road 
Benfleet 


sinclair 


Essex. SS7 4JD j 


Tel (0268) 754 407 


os 


tion of neutral territory, you are 
simply bombarded by shore 
batteries! 

A further major advance with 
version 2 was the introduction 
of a two-player option on one 
machine. This option is invoked 
upon command or an automatic 
timing system. 

Fleet Tactical Command II was 
also the version that would be 
compatible with other machine 
versions. 

In 1992, Di-Ren announced 
that the long-awaited PC version 
was ready to be shipped. | 
obtained this version as an 
upgrade. To have re-pro- 
grammed FTC to run on PCs is 
something of an achievement 
As with the QL the program has 
been produced entirely in 
machine code. | remember Di- 
Ren stating in the early days of 
FTC that machine compatible 
versions would be produced, 
and | considered it something of 
a pipe dream! Hesitatingly, | con- 
nected the QL and PC with a 


serial link lead and was amazed 
to find that the program runs 
across the two machines with 
no apparent problems. 


PC version 


The PC version of course has 
a significantly improved display. 
The ships are in-filled graphics, 
and there is also a ‘tilt’ option 
that adds to the realism, espe- 
cially in rough weather! 

Finally, FTC was never very 
cheap, and when you receive 
the package you understand 
why. As | understand it, Di-Ren 
have recently reduced the QL 
version to £39.95, And that's a 
bargain! Take my word for it! 

Here | go again. Five hours 
into the game, and I've put three 
ships aground, sunk two, have 
one under tow and (worse) 
another short of supplies. When 
will | learn? Never run out of cof- 
fee .. 


If AN ADVERT 
IS WRONG, 
WHO PUTS 

IT RIGHT? 


We do. 


The Advertising Standards Authority ensures 


advertisements meet with the strict Code of Advertising 


Practice. So if you question an advertiser, they have 


Lo answer LO US. 


To find out more about the ASA, 


please write to Advertising Standards 


Authority, Dept. 


X, Brook House, 


Torrington Place, London WCI1E 7HN. 


This space is donated in the interests of high standards in advertisements. 











VERY BASIC 
SUPERBASIC 





In this issue, Dilwyn Jones starts SELECTing what he’d like to write ON. 


looped 


and made 
decisions 
in the last 


issue, now we shall look at the 
use of the SELect statement to 
make more decisions. 


SELECT 


SELECT is a useful little key- 
word allows us to make deci- 
sions which depend on the 
value of a variable, or a number. 
Although in most cases we 
could use IF..THEN to make 
equivalent decisions, a SELECT 
statement is often more useful 
when there is a large number of 
choices which can be made. An 
example is worth a thousand 
words here, so study listing 
one. 

It consists of three main parts. 
The beginning of the decision 
making process is marked by 
the “SELECT ON a’ statement. 
The end of it all is marked with 


Listing two 


an END SELECT statement, wile 
there are various statements 
starting with ‘’ between them. 

The program chooses a ran- 
dom number from 1 to 3. It then 
proceeds to translate the num- 
ber into English words. The RND 
keyword simply chooses a num- 
ber at random between the lim- 
its specified in brackets after it 
in this case a whole number 
from 1 to 5 inclusive. 


“a” variable 


Firstly, the SELECT ON state- 
ment specifies that decisions will 
be made based on the value of 
a variable called “a”. The deci- 
sions are placed on separ ate 
lines between the SELECT ON 
statement and END SELECT 
statements. ON can actually be 
omitted, so you only have to 
type "SELECT a’, although using 
the full form is a little bit clearer 
and more meaningful. In fact, 
there is an abbre viation for the 
SELECT keyword as well - you 
only have to type the three let- 
ters SEL for it to be recognised, 


166 INPUT'What is your age?';age 


116 SELect ON age 


120 
13¢ 
149 


=§ TO 19 


=26 TO 29 


156 
160 
17@ 
186 
190 
200 
219 END SELect 


=39 TO 39 
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PRINT'A young QL user.’ 
PRINT'In your twenties.’ 


PRINT'Thirty something, 

PRINT'like the author!' 
=REMAINDER 

PRINT'Mature and experienced!’ 





Listing one 


160 
119 
126 
13@ 
146 
156 
16@ 
17@ 
18¢@ 


CLS 


PRINT ‘a is '; 
SELect ON a 
=] 
=2 
=3 


END SELect 


though | normally type it in full to 
avoid the chance of errors. 

The lines in between specify 
what action to take for each 
value which the variable takes. 
They all take the form “=num- 
ber’, where number is actually a 
number here, though it can also 
be a variable if you wish. It can 
also be a list, with values sepa- 
rated by commas, or a ‘range 
like in the RND statement, using 
the TO separator. 


Listing three 


169 LET compliment = 
11¢ BELLE ON compliment 
129 =] 


1394 =2 : 
149 =3 
156 

166 =4 
179) =5 
189 END SELect 


: PRINT'One' 
: PRINT'TWo' 
: PRINT'Three' 


=REMAINDER : PRINT'Something else.’ 


LET a = RND(1 TO 5) 





The statement 


“= : PRINTOne” 

basically means “IF a=-1 THEN 
PRINT’'One” as we learned last 
month, meaning that when it dis- 
covers that a has a value of one, 
it prints the word One on the 
screen. A fairly trivial little appli- 
cation, but it clearly shows how 
SELECT works, 

You may have noticed that we 


RND(1 TO 5) 


: PRINT"Hello, gorgeous." 

PRINT"You are looking smart today.” 

: PRINT"You must be the most intelligent" 
PRINT"QL user I have ever met!" 

: PRINT"I wouldn't swap owners for the world.” 
: PRINT"Aren't you a super person!" 





Listing four 


189 CLS 

119 REPeat loopl 
120 
136 
14 
156 
169 
179 
189 
199 
208 
210 
229 
239 
249 
256 END REPeat loop2 


END REPeat loop! 
SELect ON month 
=4,6,9,11 
=2 : no of days 


END SELect 
REPeat loop2 


only test for the numbers 1,2 
and 3, whereas the random 
number could also be 4 or 5. In 
this case, we include a 
“REMAINDER” statement which 
executes if none of the other 
has caught the value. What this 
means is that if “a” does not 
have one of the other values 
(1,2,3), the command after 
REMAINDER is executed. In this 
case it simply prints “Something 
Else’, 

We could also have written 
that statement in these ways, to 
show how the lists and ranges 
work: 


“45 
or 


“4105 


Lists and ranges can be com- 
bined into long sequences of 
values if you wish, though at first 
this may seem confusing. A 
statement such as this is quite 
legal, though in this example it is 
clearly of little use: 


=1,2,3,4 TO 5,26,30 TO 40 


Variables can be used too, 
though again of little use in this 
example. Variables tend to be 
less clear than the numbers and 
are not used as often. 

100 SELECT ON a 


INPUT'Month number (1-12):';:month 
SELect ON month=i TO 12:EXIT loopl 
PRINT'Oops, invalid entry!' 


: no_of days = 34 
= 28 
=REMAINDER : no_of_ days = 31 


INPUT'Day number:';dno 
SELect ON dno=1 TO no_of_days:EXIT loop2 
PRINT'Oops, invalid entry!' 





110 =-b:PRINT’Same as b’ 
120 -c:PRINTSame as Cc’ 
130 END SELect 


PRINT is not the only com- 
mand which can be used, all QL 
commands ‘can be used, though 
some are not very useful or 
practical, such as NEW which 
would destroy the program! 

Incidentally, if you use a 
‘'=REMAINDER’ clause, it should 
be right at the end of the list of 
‘=’ statements, to prevent it 
catching values not caught by 
other ‘=' statements which might 
be after it. In other words, it 
should be the last '’ statement 
before the END SELECT. 


Action anywhere 


In all examples so far, we have 
simply put the action statements 
Or commands on the same line 
as the ‘~’ statement, separated 
by a colon. This does not have 
to be the case, the action state- 
ments can be anywhere before 
the next '' statement - an exam- 
ple of this is in listing two. 

One small matter needs to be 
pointed out and this may be diffi- 
cult to understand at this stage. 
When testing for the value of a 
variable, it actually means 


‘approximately equal to’ not 
‘exactly equal to’, to allow for 
slight inac curacies in the use of 
decimal numbers. According to 
Jan Jones, the original designer 
of SuperBasic, in her book ‘QL 
SuperBasic, The Definitive 
Handbook’ (available from 
Quanta) the test allows for small 
rounding off errors of up to the 
seventh decimal place (plus or 
minus 1E-7). You may be famil- 
iar with the description ‘accurate 
to 7 decimal places’ sometimes 
given to calculators. In practice, 
what it means is that “-6" might 
not catch the value 5.9, but it 
should be able to catch 
6.000000001 easily enough. 
This is significant where you are 
testing for the result of a calcula- 
tion, or trying to match the value 
of something like 1/3 which 
cannot be specified exactly. 

Don't forget that you can test 
for decimal numbers as well as 
whole numbers, though on origi- 
nal QL ROM versions, you can 
only use floating point variables - 
you can't use integer variables 
(which only hold whole numbers 
and have names ending with 
the % symbol). 


Range checking 


The ‘approximately equal to’ 
rule does not apply to range 
checking. If you specify 4 TO 6, 
for example, it means just that, 
exactly equal to 4, exactly equal 
to 6, or Somewhere in between. 

There is also a short form or 


‘in-line’ version of the SELECT ‘ 


state ment which can all be writ- 
ten on one line of a program! In 


Listing five 


169 CLS 
116 LET a = RND(1 TO 3) 
126 ON a GO TO 1999,2999,3999 


136 STOP 


1960 PRINT'One' 
29606 PRINT'Two' 


this the value checks and the 
SELECT statement are all on the 
same line and there is no END 
SELECT statement All parts are 
separated by a colon. You can 
include multiple statements, or 
multiple ‘—’ clauses if you wish, 
although one is the norm. 


SECEG1 * ON“ aet. TO 
3:PRINT That is OK! SELECT ON 
a=1:PRINTOne!=2:PRINTTwo' 


That was the theory. Let us 
now look at a few simple and 
practical examples. Listing 
three shows a fun little applica- 
tion of the SELECT statements, a 
compliment generator to cheer 
up any fed up QL users! You 
could also change this to an 
insult generator (!), or for a bit of 
fun, into a buzzword generator 
which selects long words at ran- 
dom to form impressive sound- 
ing phrases which you can 
casually drop into conversations 
to sound impressive! 

Listing four shows a more 
practical use. This shows how to 
enter a month and day number 
and use SELECT to help pre- 
vent errors and ensure you get 
the right number of days in 
each month, although it doesn't 
test for leap years, where there 
would be 29 days in February. 

The routine works by using 
short form SELECTs to check 
the ranges of values allowed 
and long forms to specify the 
number of days in a given 
month number. As normally 
specified, January is month 1 
and so on. There are other, bet- 
ter ways of writing such a rou- 
tine, but it is an excellent exam- 
ple of the use of SELECT. 


: STOP 
: STOP 


3966 PRINT'Three' : STOP 
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Listing six 


16% CLS 
119 LET a = 


RND(1 TO 3) 


129 LET line number = 149 
136 ON a GO TO 1696,2606,3600 
14% PRINT'Program finished.' 


15% STOP 
19966 PRINT'One' 
2699 PRINT'Two' 


GOTO 


You may have wondered if, 
apart from ensuring that lines of 
a pro gram are sorted in the 
correct order, the line numbers 
have any other signif icance. 
The answer is yes - it is possible 
to make the program jump from 
its present line to another in a 
different part of the program. To 
do this, we use the GOTO state- 
ment, which is followed by a line 
number. In the following exam 
ole, line 110 is never executed 
when the program is started 
from the beginning: 


100 GOTO 120 
110 PRINTLine 110° 
120 PRINT Line 120 


It can also be made to form a 
‘loop’, rather like REPEAT: 


100 PRINTHello ! “ 
110 GOTO 100 


In fact, you'll notice that the 
computer enters a GOTO com- 
mand as GO TO (with a space 
between GO and TO). You do 
not have to type it in like that, it 
will be quite happy for it to be 
entered as one word. 

The GOTO statement has little 
practical use in QL SuperBasic, 
since there are other com- 
mands which can be used to do 
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: GO TO line number 
: GO TO line number 
3666 PRINT'Three' : GO TO line number 





the same things. Its disad van- 
tage is that by specifying line 
numbers it makes it difficult to 
follow a program, and difficult to 
figure out where blocks of code 


start and end. It is, however, very - 


useful when trying to convert 
programs written for other 
compu ters (Basic programs list- 
ed in a magazine or book) since 
these make more use of the 
command than the QL does, 


ON...GOTO... 


There is another way in which 
you can make decisions about 
what to do subject to the value 
of a number or variable. This 
one is shorter and some times 


more convenient than SELECT, 


but suffers from the problems 
with line number references dis- 
cussed under GOTO above. 
This is also included in Super 
Basic because it appears in 
other versions of Basic. 

The command takes the form 


ON x GOTO 1000,2000,3000 


where x is the variable being 
tested and the numbers after 
GOTO are line numbers to 
choose. These signify the start of 
blocks of code to handle the 
result. It does not appear obvi- 
ous how the choice is made, but 
it is quite sim ple. If the value of x 
is 1, the first line number is cho- 


sen. If the value of x is 2, the 
second is chosen and so on. If 
the value is too low or too high 
for the amount of line numbers 
you've given, the computer gives 
an error report (‘Out of range’) 
and the program stops. 

Listing five is a version of list- 
ing one, rewritten to use 
ON..GOTO.. 

Don't forget that the use of 
GOTO is frowned upon in QL 
SuperBasic, though there's noth- 
ing to stop a consenting adult 
using it in private with his/her 
QL! 


Getting lost! 


When using GOTO or 
ON..GOTO to make a program 
jump to another part of the pro- 
gram, it is possible that it might 
get lost and not know where to 
come back to after it has fin- 
ished the new block Programs 
are often written in sections like 
this, especially where two parts 
of a program use the same lines 
of code, It allows you to avoid 
duplication and repetition - a 
part of a program can be written 
as one chunk at the end and 
called with a GOTO from one 
point and from another point, 
though you have a problem try- 
ing to remember where to go 
back to. One solution is to use a 
variable to remember it Here, | 
will be using a REMark state- 
ment to mark out bits of code as 


Listing seven 


166 CLS 
119 LET a = RND(1 TO 3) 
128 ON a GO SUB 1969,2996,30960 


examples. A REMark statement 
is just that, a remark or com- 
ment to include information for 
you to read. It is ignored by the 
computer. The example is In 
listing six. 

Here, the variable line_number 
holds the number of the line to 
go back to after executing the 
block at the end of the program. 
This works, but is not very ele- 
gant (in fact it is downright horri- 
ble). 

SuperBasic provides a far bet- 
ter solution to all this. It has a 
command which allows you to 
jump to another section of code, 
remembering automatically 
where it came from. At the end 
of a section of code is a 
RETURN command which tells 
the computer to go back to just 
after where the last call was. 
This block of code at the end of 
the program is called a subrou- 
tine, because it is not the main 
routine. The command to call it 
is not surprisingly GOSUB 
(which means go to subroutine). 
The GOSUB command is fol- 
lowed by a line number. When 
encoun tered, the program 
jumps to that line number and 
continues until it reaches the 
RETURN statement, then jumps 
back to where it left off See the 
example in listing seven. 

SuperBasic provides struc- 
tures which are far more clever 
than this, doing away with the 
need for line numbers altogeth- 
er. These are called proce 
dures and functions and will be 
discussed in the next instalment 


139 PRINT'Program finished. ' 


149 STOP 
1900 PRINT'One' 
2008 PRINT'Two' 


>: RETurn 
: RETurn 


3660 PRINT'Three': RETurn 











Simon Goodwin reports on the long-awaited release of 
Xchange for the QL. 


his year Psion Plc 

gave permission for 

the West Midlands QL 

User Group to distrib- 
ute the full Psion Xchange 
suite to QL users. This package 
is potentially interesting to all 
QL users, as it may be freely 
copied and is a major update 
on the Psion software bundled 
with each QL You need at least 
384K ram and one disk drive 
to run the suite - the more the 
better. 


Part-Xchange 


This article explains the extra 
features in this version of 
Xchange, and discusses useful 
files which have been added to 
the PD release. Pirate copies of 
Xchange have circulated for 
several years, hacked from the 
Thor version. These should not 
be confused with the PD 
release, which has a cursor in 
the top left corner, so it will run 
with EXEC and multi-task with 
Basic, and comes with a full set 
of support files including printer 
drivers and tutorials. 

All the versions hacked prior 
to permissions being given by 
Psion that | have seen contain 
errors; one, styled as ‘Turbo 
Xchange’, is bloated by need- 
less extra code and will only 
work in conjunction with Qram 
or Qpac. Another hacked copy 
has 64 bytes missing from the 
start, so it shows no task name 
and you cannot control its 
memory usage. The new West 
Midlands version is 183718 
bytes long, and comes on a 
720K disk full but for three sec- 
tors, Accept no substitute. 


Xchange story 


Psion Xchange was born in 
1988 as a suite of four busi- 
ness programs for the Sinclair 
QL computer. The first versions 
were programmed in C and 
tested on a Vax mini-computer; 
they barely fitted the 128K QL 
memory. Subsequently Psion 
updated the programs to ‘ver- 
sion 2’, re-coding them in 
assembly language to boost 
speed and save memory. 

Xchange has four parts, famil- 
iar to QL users: Quill, Abacus, 
Archive and Easel. Sinclair 
supplied these as four separate 
programs, but the full Xchange 
suite combines them into a sin- 
gle task, about 180K long, with 
many extra features and 
improved communication 
between the parts. 

Once QL Xchange was com- 
olete Psion converted the code 
to run on ICL's One Per Desk 
office workstation. This has the 
same 128K ram as a standard 
QL, and much of the same 
hardware, but uses a bigger 
rom which holds the entire 
Xchange package and built-in 
software added by ICL The 
One Per Desk can run 
SuperBasic programs, but the 
interpreter must be loaded 
from microdrive cartridge 
before use, 

For years rumours of a rom 
version of Xchange for the QL 
circulated, but it never arrived. 
Psion went on to convert the 
suite for IBM PC compatibles, 
launching the full Xchange at a 
price to match the entire QL 
system, and PC-Four, a cut- 
down version comprising four 
separate programs rather than 
the integrated set. 


In 1986 the Thor consortium 
started work on a follow-up for 
the QL, and paid £30,000 for a 
Thor-specific version of 
Xchange, combining the four 
QL packages into one task and 
adding features from the One 
Per Desk version. In the event 
the conversion was much more 
work than expected, and went 
way over budget. 

The Thor consortium tried to 
obtain further updates, but 
were unable to find the neces- 
sary finance. Thor version 3.90 
was the last official release of 
Xchange, although a few jolly 
japesters have patched the ver- 
sion numbers of copies to 
make them seem more up to 
date. 

On 28rd February 1993 
Psion Plc generously gave per- 
mission for the distribution of 
QL-specific Xchange software 
freely (while retaining their 
rights), for the Sinclair QL and 
its derivatives plus the Thor XVI, 
Amiga and Atari running Qdos. 
The PC versions (Xchange and 
PC Four) are not affected by 
this decision, and must not be 
copied except under commer- 
cial licence from Psion. 

A few days later former 
Dansoft boss Helmuth Stuven 
contacted Sinclair QL World 
to announce that Thor bundled 
software was also freely distrib- 
utable. This meant that QODUMP 
and other Dansoft accessories 
could be included in the new 
release, 


Getting started 


If RAM1_ is available you can 
start the Xchange task directly 
with an EXEC, EXECUTE or EX 
command. Xchange requires 


A Fair Xchange 


about 500K including for 
default 3OOK data-area, and 
also uses space on RAM 1_. 
You can reduce the data-area 
available for Xchange tasks by 
adding a parameter (eg EW 
"XCHANGE”’90" for 9OK) in an 
EW, QW or EXECUTE_W 
Toolkit command. There's no 
need for a ‘grabber’ to stop the 
task taking all your memory. 

If you have no ram drive you 
can simply put the Xchange 
disk in drive 1, then load 
Xchange with the command 
LRUN FLP1_BOOT. This sets 
up a 5OK ram disk; edit the 
SuperBasic if your machine 
has a builtin ram drive, or con- 
sult INTRO_DOC to find out 
how to change the size. 

The main Xchange menu is 
new to QL users, and lets you 
start up to eight Psion tasks 
from the set of Quill, Archive, 
Abacus and Easel. It also incor- 
porates options like BACKUP 
which used to occupy the files 
menu in each. task 

You swap between tasks by 
pressing F6 to return to the 
main menu, then selecting the 
next task from a menu. Only 
one task runs at a time, but 
‘packground’ printing lets you 
print one file as you work with 
others. In general Xchange is 
faster than the QL tasks as 
David Oliver patched the code 
to remove redundant Qdos 
calls. 

The eponymous XCHANGE 
option lets you move data 
between tasks, automatically 
swapping screens and issuing 
EXPORT and IMPORT com- 
mands, but this will not 
EXPORT from Quill, even 
though that now boasts an 
EXPORT option. More flexibly 
you can program arbitrary 
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command sequences with the 
TSL Task Sequencing 
Language, which works like 
‘macros’ in other languages. 


Task sequencing 


TSL programs consist of a 
sequence of key presses, 
optionally interspersed with 
commands and line-labels. 
When you run the program, the 
commands and labels are fil- 
tered out, and the remaining 
characters are interpreted as 
though you were typing them at 
the keyboard. 

TSL programs are text files 
which can be generated with 
any Ascii text editor, including 
Devpac, ED, Editor, Spy and the 
Xchange version of Quill, which 
can export Ascii text Some QL 
Quill fans use a special printer 
driver to get the same effect. If 
you use Xchange Quill the easi- 
est way is to press F3 O F for 
the files menu, then E to Export 
text, followed by the file name. 
The extension _TSL must be 
supplied, or Quill uses the 
default _EXP, which will not be 
recognised as a TSL file. 

Spaces appearing in the pro- 
gram may be significant. Except 
within a TSL command, any 
space in a program is interpret- 
ed as though you had pressed 
the space bar. Other key-press- 
es, like function keys, arrow 


TABLE - 


Equivalent key 
Carriage Return (ENTER) 
Escape key (ESC) 

Space (in TSL commands) 


Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 


key 
key 
key 
key 
key 
key 
key 
key 
key 


keys and Enter, are especially 
difficult to represent in a text 
file, so they have symbolic 
names which can be used 
instead of the character itself. 
These symbols use short 
mnemonics enclosed in square 
brackets. The TSL table shows 
valid symbols and their mean- 
INQS. 

The standard QL keyboard 
does not include F6 to F10, but 
the equivalent codes are gen- 
erated by keying Shift with F1 
to F5, so [f10] corresponds to 
Shift-F5, which re-draws the 
entire screen. The sequence 
[sf5] represents Shift-F5, and 
has the same meaning. Thor 
Argos, Amiga Qdos and many 
extended QL keyboards sup- 
port the extra keys F6 to F10, 
and these come in handy when 
using Xchange - for instance, 
F6 calls up the main Xchange 
task control menu from any of 
the four packages, and F9 tog- 
gles between insert and over- 
write mode, like Shift-F4 in QL 
Quill. 


TSL commands 


You can include special TSL 
commands in a file as well as 
key-presses. Each command 
consists of an ampersand (&) 
followed by a distinguishing 
character. It must start at the 
beginning of a new line. Some 


Code 
[it] 
[rt] 
[up] 
[dn] 
[bpr ] 
[epr ] 
[wlt ] 
[wrt ] 
[bln] 
[eln] 
[alt] 
fart] 


TSL COMMAND SUMMARY 


If the specified character matches the one pressed 

in response to the most recent &g, jump to the label 
specified. The test is case-dependent. To jump to @FUN 
if the last response to &g was ENTER, use: &= [cr] FUN 


Comment; the rest of the line is ignored. 


Display text to the user (see &p). 


End of program - stops TSL. 


Get character - waits until a key is pressed. 
The key press can later be tested with &=. 


INPUT; waits for text to be typed. After ENTER 
the text is passed to the task. 


Jump to the program line marked by the following 
label. To jump to the label @loop use: &j loop 


Disables TSL messages at the top of the screen, 
so Xchange prompts appear as normal. 


Permits TSL messages. This is the default. 


Wait for this number of tenths of a second. 


To wait for six seconds use: 


&w 60 


Wait for a specified key to be pressed; e.g. 
&x A waits for the capital A key to be pressed. 


Wait for a specified key to be pressed; ignore case. 


of the commands accept text 
or numeric parameters, TSL 
supports eleven commands, 
also listed in the table. 

Lines may be labelled with 
text so that commands can 
refer to them by name. Labels 
names start with an at (@) char- 
acter and must be the only 
thing on the line. You should 
not include the at sign in com- 
mands that refer to the label, 
such as &dJ , similar to Basic’s 


Xchange TSL Key Codes 


Equivalent key 
left Arrow 
right Arrow 
up Arrow 
down Arrow 
SHIFT up 
SHIFT down 
SHIFT left 
SHIFT right 
ALT left 
ALT right 
CTRL left 
CTRL right 





GO TO, or &=, which resem- 
bles an IF test. 

The special meanings 
assigned to square brackets, @ 
and & signs, make it difficult to 
enter them literally in TSL, so 
Psion use “ as an ‘escape’ 
character, rather like \ in C or 
Unix. If you want TSL to take 
one of these characters literally, 
add a “ before it, So &= A@ 
HOME sends TSL to the line 
labelled HOME if the last key 
pressed was @, and &x AA 
waits for the “ key-press. 

To start a TSL tutorial, press 
F6 (or Shift-F1) to return from 
the current application if the 
Xchange menu is not yet dis- 
played, then press FS and 7, 
then enter the TSL file name. 


Documents 


The new documentation con- 
sists of a two page introduction 
and three pages of TSL details, 
plus 26 demonstration _TSL 


FPWUOON AU PWNHE 


Function 
SHIFT 
SHIFT 
SHIFT 
SHIFT 
SHIFT 


key [adwlt] 
[dwrt ] 
[dbln] 
[deln] 
[tab] 

[btab] 


SHIFT CTRL left 
SHIFT CTRL right 
SHIFT ALT left 
SHIFT ALT right 
TAB 

SHIFT TAB 


files which show the extra fea- 
tures of Xchange in action, 
These tutorials range in size 
from a hundred bytes to 30K 
Or more, and have been collat- 
ed from several sources includ- 
ing CST, Dansoft and Chas 
Dillon, and adapted to link from 





24 SINCLAIR QL WORLD 


one to another, starting with 
BEGIN_TSL or MENU_TSL 

The original THOR 1 
README_DOC is included on 
the disk, along with the pro- 
grams that it mentions that 
work on the QL The package 
also includes about 100K of 
context-sensitive help files. If in 
doubt at any time, press F1 for 
help from Xchange itself. 

The Thor’s PC-style keyboard 
includes HOME and END keys 
which are intended to move the 
Cursor directly to the start or 
end of the line. Xchange recog- 
nises these, and you can get 
the same effect on a normal QL 
keyboard with Alt-left and Alt- 
right 

The Xchange Quill Glossary 
is similar to Toolkit II's ALTKEY 
feature, or the key-define fea- 
ture in Turbo-Quill (which is not 
compatible with Xchange). It 
lets you assign a sequence of 
characters to any alphabetic 
key, and call them up with the 
glossary key F5, unused in QL 
Quill. 

To teach Xchange a Glossary 
key, press F5 twice, then the 
letter you want to assign, fol- 
lowed by Enter. From that point 
Onwards until you press F5 
again, Quill records all the keys 
you press, up to a maximum of 
250 key-strokes. Once a glos- 
Sary is set up you can call up 
the sequence by pressing F5 
and the chosen letter. 

Psion suggest that you could 


isi 


use the glossary to save typing 
common phrases, like ‘yours 
sincerely’ or your own address. 
Current glossary definitions are 
saved when you quit Xchange 
and re-loaded when you start 
again from the same disk. 


File types 


The new EXTRACT option on 
Quill's Files Il menu lets you 
write part of a file to disk in 
Quills _DOC format, with for- 
matting intact. You can then 
use MERGE to load it else- 
where. This is quicker than 
COPY even if you are just mov- 
ing the block from one end of a 
file to the other, as you can use 
GO TO or other commands to 
move once the block has been 
extracted, By default the block 
is stored in BUFFER_DOC on 
the default drive, but you can 
specify an alternative name or 
device - | normally use RAM1_. 

Quill documents have two 
main parts - the text, and the 
paragraph table which keeps 
track of the format and grows 
periodically as the file expands. 
Quill generates a new para- 
graph table for extracted 
blocks, So you can often 
reduce the size of a _DOC file 
by selecting it all as a block, 
and extracting it; this eliminates 
space which may have been 
added to the paragraph table 
but not yet used. | use this tech- 


lise space to select the task 
Press ENTER 20 start the task 


TASK TABLE 





QUILL = Action 
ABACUS - Eric 
ARCHIVE - Simon 
EASEL - DIYlook 
ABACUS =- NEW TASK 
QUILL - NEW TASK 
ARCHIVE = NEW TASK 
EASEL —- NEW TASK 


MENORY USED 


4 Kbytes 
6 Kbytes 
3 Kbytes 
4 Kbytes 


help 


exec cf lpt. HPOUE D TARR “PRT” 


nique to ensure that DIY Toolkit 
text files fit on 128K QLs, which 
limit Quill to documents of 
around 10240 bytes, 

Ascii export is a long-awaited 
feature added to the FILES 
menu in Xchange Quill. 
EXPORT writes the entire file to 
a drive, removing control 
codes, Unlike SAVE it does not 
forget the cursor position, so 
you can carry on from just 
where you left off. MAIL is 
another new FILES option. It 
generates personalised form 
letters by merging a template 
document with data from the 
keyboard or a _DOC or _EXP 
file. 


Better names 


By default Xchange uses the 
same eight-character file 
names as QL packages, adding 
a three-character PO-style 
extension to distinguish 
between file types, but one of 
the nice Thor extensions 
means you can specify a full file 
path, allowing direct access to 
sub-directories or files grouped 
by prefix. 

You are not restricted to the 
three-character extensions, 
although you may avoid confu- 
sion if you stick with them. For 
instance FS S flo1__DIY_TEST 
generates a file called 
"DIY_TEST"; you have to specify 
flo1_DIY_TEST_DOC to create 


"DEVICES 


default fipl_ 
nl_flpl_pston_help_ 


PRINTER STATUS 
not printing 





TEST_DOC in sub-directory 
DIY. The default devices are 
derived from the PROG_USE 
and DATA_USE names set up 
by most disk systems, but you 
can change these with the SET 
option from the Xchange F6 
menu. | 

The first default is used to find 
data files, unless an explicit 
device is named. Curiously, it is 
also used to find printer files 
such as GPRINT_PRT and 
XCHANGE_DAT, The other 
default tells Xchange where to 
look for help files. These are 
extended versions of the help 
files used in the QL bundle, and 
include a new file, 
XCHANGE_HOB, which 
explains new commands in the 
Supervisory F6 menu. 


Abacus 


The Abacus spreadsheet 
recognises the same functions 
as the QL version. The FILES 
menu includes a new ‘transfer’ 
option to save or load the 
spreadsheet as an Ascii DIF file 
or in Psion’s own binary _ABT 
format. There is no FORMAT 
option here or elsewhere, but 
you can Control C out to Basic 
any time you need to format a 
disk or cartridge. 

The new TITLES command 
fixes outer rows to the border, 
SO beyond the cursor scrolls 
while the headings stay put. 
The GRID menu gains many 
new options. PROTECT and 
UNPROTECT let you guard 
cells against overtyping over 
formula amendment. SECURITY 
protects spreadsheets with an 
eight character password, 
REPEAT re-calculates the num- 
ber of times you indicate while 
GOALSEEK re-calculates until 
the supplied formula evaluates 
to zero. 


Easel 


Easel now supports 3D 
graphs, changing the viewing 
angle automatically so you can 
always see the height of all the 
bars. It gains some new func- 
tions: RAD and DEG work like 
their Abacus namesakes, while 
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Fair Xchange 





CELL and CELLMAX return the 
indices of the ‘cells’ that hold 
columnar data. 


Archive 


Archive gains the LOAD USR 
command added to the 
Archdev development version. 
This loads position-independent 
machine code which can sub- 
sequently be called with the 
USR function. This takes two 
parameters. The first, a long 
word, is passed in and out of 
the code via register DO. The 
second must be a string vari- 
able. The address of a string, 
prefixed by a length byte, ends 
up in register AO. The code can 
modify the text but must not 
change the length, 

The file must start with the 
characters “PMCO", followed by 
a word value - the length of the 
subsequent code, in bytes. 
About 1K of stack space is 
available and all the registers 
may be used, The code should 
end with an RTS instruction. 


Printing 


Psion’s slow and memory- 
hungry INSTALL_BAS has been 
replaced with a compiled ver- 
sion, but otherwise works just 
like the QL equivalent. QL 
PRINTER_DAT files work as 
soon as you rename them to 
XCHANGE_DAT. 

A new program, 
CHOOSEPRINTER_BAS, lets 
you pick your printer definition 
from a range of pre-set files for 
SER and PAR devices. These 
Support about a dozen old 
matrix and daisywheel printers, 
but few recent models apart 
from Epson-compatibles. Of 
course you can edit the exist 
ing files if you find something 
that is almost but not quite what 
you need, 

| have added a simple 
DeskJet definition for the most 
commonly-used Quill control 
codes, but this does not cur- 
rently Support superscripts and 
subscripts. If this bothers you, 
add the sequences tabulated in 
Open Channel in issue 5 
(May) earlier this year. 
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Extension files 


The public domain ramdisk 
from Amiga Qdos appears on 
the disk, in case would-be 
users need a way to set up 
RAM1_, which is required for 
temporary files as Xchange 
runs. XCOPY_BAS is a fast 
copier for the Xchange task file, 
which uses a temporary buffer 
in memory to save and load the 
entire file in one go. You need 
to install SuperToolkit 2, or load 
Mark J Swift's PD Toolkit (LRUN 
FLP1_PDTK_BOOT) to use 
XCOPY_BAS. 

QDUMP_INSTALL_BAS has 
been altered to work on 
Sinclair roms, Amiga and Atari 
emulators, and Minerva (in one 
or two screen mode), by 
adding a SuperBasic 
SYS_VARS function to emulate 
the Thor rom equivalent You 
may delete those lines from the 
end of the listing if you habitual- 
ly use Argos or Turbo Toolkit 3, 
which implement SYS_VARS 
more flexibly as a resident func- 
tion. 


Limitations 


There are still a few bugs in 
Xchange that were fixed in very 
late releases of the separate 
QL tasks. In particular, the index 
used by Archive is limited to 
32K, as on QL versions before 
2.38. The Archive program 
token format is the same as 
that used by Runtime Archive 
and ArchDev, and different 
from that of QL Archive version 
2. 

You can load Ascii program 
files with the extension _PRG, 
regardless of their source, but 
tokenised files with the exten- 
sion _PRO may need to be 
converted before they will load. 
The easiest way to do this is to 
load them with your original 
copy of Archive and save them 
Out as _PRG files. 

Quill sometimes gets the cur- 
sor position wrong while edit- 
iNg, as was common before QL 
version 2.35. If this happens to 
you, press Shift-F5 (or F10 on 
extended keyboards) to re- 
draw the screen and fix the 
cursor, 


David Moseley and Rich 
Mellor of West Midlands 
Quanta report a bug in the 
Xchange version of Abacus, but 
this only affects late Minerva 
roms, like their version 1.93. 
When they try to Amend an 
Echoed formula the QL crash- 
es in what Tony Tebby once 
memorably described as ‘fart 
and pyjamas’ mode, with a 
striped screen and random 
noise from the speaker and 
microdrives. The fault does not 
appear on a JM machine with 
Gold Card, Amiga JS, or Phil 
Spink’s early Minerva 1.64, so 
this seems to indicate a new 
Minerva bug, 

Psion have always had trou- 
ble coping when memory runs 
short, and this is true for 
Xchange, despite many fixes. 
The suite can get stuck if it 
runs out of memory on RAM1_. 
To avoid trouble, make sure 
there's plenty of room for tem- 
porary files on RAM1_ before 
you start. Xchange generates a 
small file XCHANGE_TMP for 
task details, and one temporary 
file - similar to DEF_TMP on 
microdrive - for every task in 
use. They disappear when you 
Quit from Xchange. 


Obtaining 


Xchange 


The new release of Xchange 
is available free to members of 
the West Midlands QL User 
Group, a Quanta sub-group 
which meets on the first and 
third Monday of each month at 
the Holtoway pub, just off 
Birmingham's Inner Ring Road. 
Bring a blank 3.5-inch disk to 
any meeting to get your copy. 
Non-members should join us! 
Or send an empty 720K for- 
matted disk to the secretary 
with return postage and pack- 
ing and a cheque or postal 
order for two pounds, made 
out to QL User Group (WIV). 
Write to Mike Bedford White 
at 16 Westfield Road, 
Birmingham, B27 7TL, UK. 
Xchange is also available from 
other Quanta groups, and 
Qdos PD suppliers like 
Qubbesoft and SJUPD. 


Payment Power 


Peter 
Tomlin’s QL 
keeps track 
of his 
household 
electricity 
costs. 


€ wondered 
why Our 
electricity 
consumption 
varled so 
much, It was not just at 
weekends when everyone was 
at horne. | used my Abacus to 
set out dally meter readings, 
but | soon wanted more data 
io hana, ano it becamse slow 
and laborious shifting arounc 
ihe spread-sheei all the time 
to get what | wanted, 

So gradually | ceveloped 
this program, which has 
proved very useful and with 
which we have been able to 
reduce our bills. 





Simple SuperBasic 


The SuperBasic program 
does not require much 
explaining. Some of us do noi 
have access to extra toolkits 
with facillties io RENAME, anc 
OPEN, OVERW‘RITE files, so 
things have been kept! as 
Simple as possible, and all on 
one aisk, Mcv can of course 
be substituted for flip. 

When starting io use the 
prograrn for the very first time, 
there Is another program 
called “Starter”, which initiates 
flles and can also be used to 
Clear off ola data and begin 
again when too much 
information has accumulated. 

At the start o: both programs 
one has the option of 
amending Unii Price and 
Standing Charge if ihey are 
different. Should you need to 
amene therm in the miccle of a 


| 
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Examples of Screens 









Last reading was 30753 . Cost 5¢ far 


What is present reading ? 30787 
Enter tine & date (hhimn Dt Han Day) 
e.g. 09:00 09 Jul Thu 





This reading -) Units used -) 271 






Standing Charge £12.22 







(units @ 7.5lp) 
DORRaNGS 


Ta calculate cost: 


Last reading -) Units used then 
(on 16 Sep) -> 610 


~ at tine of Official Reading:- 

- at any tine:- 

- of nightly useage:- 

Just to see previous useage:- Seelog 
Just to see last 2 bills:- Look 


Last Bil] ? Jun Bill 


30898 | 30388 


Cost so far is ~> (£32.72) = £20.5 + St.Chge £12.22 








Last this Units Cost of Tine & date 
reading reading used units used of reading 








Reading wes 



















i Jul 
eT 30746 30753 «7 £.52 09:00 31 Jul Fri 
cee erie 8 oir ruan Oe 30753 30787 34 £2.55 09300 05 Aug Wed 
Cost of Units £45.81 ! £49.97 30787 30793 6 £.45 09:00 06 Rug Thu 
Staring Charee £12-22.1.£12.16 30793 30800 7 £.52 09:00 07 Aug Fri 
30900 30822, 22 £1.65 09:00 10 Aug fon 
Bill tot gal ree : 0848 26 «21.9 09:00 14 Aug Fri 
beater? seat bee 30848 30880 32 £2.4 09:00 19 Aug Wed 
asat 16Sep tasatioun| | 30880 30899 19 £1.42 09:00 22 Aug Sat 











Aug Thu 


Dfficial reading today. 16 Sep 


30998 
Standing Charge £12.22 


Enter meter reading fron this bill 29719 
Now reading from bill before that 28801 


(units @ 7.51p) 


Fron this bill 

enter time & date (hhipm 
e.q. 0:00 
—)> # 


Last reading ->| 30388] Units used -> 610 
Last tine -) 663 
— on 10 Jun 


This bill will be -) [£58.03] Last bill -) £62.13 


Dt Men Day) - guess tine 
G3 Jul Thu 





Input Screen for “Nu” Procedure. 


Menu Screen. 


Procedure “Look” output Screen, 


Starter Program input Screen. 


Procedure “Now” output Screen. 


“Nu” output & "“Seelog" Screen. 


“Met” output Screen. 


session the facillty can be 
accessed again by RUNning 
the program again. In the very 
beginning the facility would 
have to be used In the Starter 
program, and also In the Main 
program. But all this Is only 
necessary if the Unit Price and 
Standing Charge have bbeen 
changed by the Gas or 
Electricity suppliers, 


The Menu 


Next, there Is the list of 
commands, or the Menu. 

Procedure “Met”, when 
ised, will permanently update 
the record and let you know 
what the bill is, after the meter 
reader has been and before 
the bill arrives in the post. 
Whether or not you feel that 
you need this information 
Straight away, It will be 
needed eventually to update 
the program, 


The procedure 
“Now” only 
reads the record 
to tell you how 
much bill you - 
have run up so 
far. Nothing is 
permanently 
altered by this. 


“Nu" Is the procedure | 
Started with. It updates a 
continuous record of all your 
perlodic readings with the time 
and date alongside, so thal 
readings can be related to 
conditions on that day. After 
breakfast was the best time for 
US to lake a reading, when 
only the fride ano the freezer 
would be in ongoing use to 
this evening. 

The running record can be 
viewed at any time without 
causing alterations by using 
the procedure “Seelog”. 

The procedure “Look” will 
show both bills from the last 
two Official quarterly readings. 

The groups of figures 
printed in the oddly-numberea 
line 2031 are simply to assist 
In spacing out the following 
line, and can be eliminate If 
desired. 


Progras "Starter" 

100 MODE 4 

110 WINDOW #1, 462, 206, 26,10 

120 WINDOW #2, 442,206, 26,10 

130 WINDOW #0, 462,40, 26,216 

140 PAPER #1,0:PAPER #2,0:CLS:INK 4:CSIZE 0,0:INK #0,7 

150 UChge = 7.51:SChge = 1222 :REMark >>> all in pence! <<<* 

160 PRINT\\\\\" Based on: Units*!UChge;"p & Standing charge 


£°;SChge/100;".° 

170 PRINT" eit =SRE sssss* 
180 PRINT\" if correct enter OK" | 
190 PRINT" zscsesss* 

200 PRINT\" if different enter No” 
210 PRINT® zsszezsz" 


220 REMNark S#dSSSEEEEESSEESERESELSEEESELESESEEE ESE SE 

230 DEFine PROCedure No 

240 CLS 

250 INPUT\\\\" Enter unit price IN PENCE:- "!UChge 
260 INPUT =" Enter standing charge IN PENCE:- "!SChge 

270 CLS 

280 GO TO 160 

290 END DEFine No 

300 REMark #ESHESESEESEESESEESETESEREEEREEESEET ELE EE 
310 DEFine PROCedure OK 

320 CLS 

330 INPUT\\\\" = Enter meter reading from this bill"'a 
340 INPUT® Now reading from bill before that"!b 

SO c=a-b 

360 d = INT(UChge # c)/100 

370 PRINT\" From this bill’ 

380 PRINT" enter tise & date (hhi:am Dt Mas Day) - guess tise if 
uncertain.” 

390 PRINT" @.g. 09:00 09 Jul Thu" 

400 INPUT® oh MIC 

410 DELETE flpi_test file 

420 DELETE flpi_newtest_file 

430 DELETE flpi_seter_file 

440 OPEN_NEW #5, flpl_test file 

450 OPEN_NEW #5, flpi_aeter file 

460 PRINT #5, bl\a\c\d\tia$ 

470 PRINT #6, a\c\d\tia$(7 TO 12)\SChge/100 

480 CLOSE #6 

490 CLOSE #5 

300 LRUN flp1_Bill 

910 END DEFine OK 


Main Prograa "Bill" 

100 MODE 4 

110 WINDOW #1, 442,206, 26,10 

120 WINDOW 2,442, 206, 26,10 

130 WINDOW #0, 452,40, 26,214 

140 PAPER #1,0:PAPER #2,0:CLS:INK 4:CSIZE 0,0: INK #0,7 

150 UChge = 7.51:SChge = 1222 :REMark >>> all in pence! <<<" 
160 PRINT \\\\\" Main Progras®” 

170 PRINT" ssxsse2sex22" 

180 PRINT® Based on: Units"! UChge;"p & Standing charge £; 


SChge/100;".° 

190 PRINT" eee ssa= ssz2z" 
200 PRINT\" if correct enter OK" 

210 PRINT" Sesasazz" 

220 PRINT\" if different enter No* 

230 PRINT" sezssszs" 


240 REMark SHSSESEESESEESESLEE ESSE AR ELE TELLELEE 

250 DEFine PROCedure No 

260 CLS 

270 IWPUT\\\\" Enter unit price IN PENCE:- “"‘UChge 
280 INPUT 860" = Enter standing charge IN PENCE:- “!SChge 
290 CLS 

300 PRINTsPRINT:PRINTs PRINT 

310 60 TO 180 

320 END DEFine No 

330 REMark SeSSERESESEEEEREESELEREELEL EES EEEE TE 

340 DEFine PROCedure display 

350 CLS:CLS #0 

360 OPEN $6,8cr_65xiGa235x175sPAPER #4,7:CLS $4: INK 6,0 
370 BORDER #5,2,2,2 

380 OPEN #7,scr_65xi6a235xi38:PAPER #7,0:CL5 $7: INK 87,4 
390 BORDER #7,2,2,2 

400 OPEN #8, scr_S5x1ba235xh6:PAPER #8,0:CLS SB8:INK #8, 4 
410 BORDER #8,2,2,4 

420 END DEFine display 

430 RENark FEPSSEERESELEEEESE LESSEE LE ETETER ES ES 

440 DEFine PROCedure OK 


450 CLS:CLS #0 

460 CSIZE O,1:AT 21,2, 11:PRINT"Commands® 

470 CSIZE 0,0:AT #1,4, 11sPRINT®----~---" 

480 AT $1,7,11:PRINT “To calculate cost: Enter" 
490 AT $1,8,48:PRINT °---------* 

500 AT #1,9,16:PRINT °~ at time of Official Reading:- Het“ 

S10 AT #1,11,16:PRINT "- at any tiae:- Now" 

920 AT 1,13, 16sPRINT "- of nightly useage:- Nu" 

930 AT #1,15, 16sPRINT “Just to see previous useage:- Seelog" 

540 AT $1,17,16:PRINT “Just to see last 2 bills :- Look" 


590 END DEFine OK 

560 REMark SERESESERSESSSERESEESEESEEESEEEEE EEE 
570 DEFine PROCedure cue 
380 PRINT #0," 

590 END DEFine cue 
600 REMark SERSEEESSESEETESERESEARSEEES ESSE ERES 

610 DEFine PROCedure Ret 

620 LOCal ¢,5,t,u,v$,0,x, y$,z 

630 OPEN_IN #5, flpi_aeter_file 

640 CLE:CLS #0 

650 PRINTsPRINTs:PRINTsPRINTs PRINT: PRINT 

660 INPUT" What is present reading ? ‘“!r 

&70 PRINT" Enter date (Dt Mam)’ 

680 PRINT® e.g. 09 Jui” 

690 INPUT® wy Shue 

700 CLS 

710 display 

720 PRINT #8," “sr 

730 PRINT 

740 PRINT 

750 PRINT 

760 INPUT #5, s 

770 INPUT 45, t 

780 INPUT 45, u 

790 INPUT #5, v$ 

800 INPUT 45, z 

Bid CSIZE O,i:AT #1,1,25:PRINTOfficial reading today,"'y$ 
820 CSIZE 0,0:AT $1,4, 25sPRINT®-----------~------------------ . 
B30 AT $1,17,12:INK 2:PRINT "This bill will be -->* 

840 AT $1,17,47:PRINT°Last bill -> £*3u + z 

850 PRINT #7," "ss 

860 w2zr-3 

870 AT 81,13, 47:PRINT"Units used ->"!w 


Enter OK for Henu® 


880 AT $1,14,47:PRINT*Last tiae ->*'t 

890 AT #1,13,12:INK 2sPRINT"Last reading <==)* 

900 AT $1,15,47:INK 4:PRINT® ~- on"! v$ 

910 AT €1,9,12:INK 2:PRINT "Standing Charge 
(units @ ";UChge;"p)° 

920 x = INT(UChge * w)/100 

930 PRINT 

940 PRINT 

950 PRINT 

960 PRINT #6," £"3x + (SChge/100) 

970 CLOSE #5 

980 DELETE flpi_seter_file 

990 OPEN_NEW 84, fipi_meter_file 

1000 PRINT #4, Fr 

1016 PRINT #4, w 

1020 PRINT #4, x 

1030 PRINT #4, y$ 

1040 PRINT #4, SChge/100 

1050 PRINT #4, s 

1060 PRINT 84, t 

1070 PRINT #4, u 

1080 PRINT #4,v$ 

1090 PRINT #4, 2 

1100 CLOSE #4 

1110 CLOSE #6 

1120 CLOSE #7 

1130 CLOSE #8 

1140 cue 

1150 IWK 4 

1160 END DEFine Met 

1170 REMark SESESRRESELERSEERESESETESEE EE SHEE EE 

1180 DEFine PROCedure Now 

1190 LOCal r,s,t,u,v$,w,x,z 

1200 PAPER O:CLS:INK 4:CSIZE 0,0 

1210 CLS # 

1220 OPEN_IN #5, flpl_meter_file 

1230 INPUT #5, s 

1240 INPUT #5, t 

1250 INPUT #5, u 

1260 INPUT 45, v$ 

1270 INPUT #5, z 

1280 PRINT 

1290 PRINT 

1300 PRINT 

1310 PRINT 

1320 PRINT" As at"!'v$!"Bill reading was"!s 

1330 INPUT" What is this reading ?"!r 

1MOw2r-s 

1350 x = INT(UChge # w)/100 

1360 display 

1370 CSIZE 0,1:PRINT\ * 

1380 CSIZE 0,0:PRINT ° 

1390 PRINT #8,° “sr 

1400 PRINT 

1410 PRINT 

1420 PRINT 

1430 AT 81,17,12:INK 2:PRINT "Cost so far is ~-->* 

1440 PRINT 87," "3s 

1450 AT #1,6,12:PRINT*This reading ay" 

1460 AT #1,6,47:PRINT"Units used ->"!w 

1470 AT #1,17,46:PRINT*= £°3x!" + St.Ch.£"3SChge/100 

1480 AT #1,13,12:INK 2sPRINT"Last reading --}* 

1490 AT $1,14,12sPRINT" (on"'v6;")* 

1300 AT #1,13,47sPRINT"Units used then” 


£*3SChge/100;* 


Cost so far:" 


VEE ePOeVed 





1510 AT #1,14,58:PRINT*->*!t 

1320 AT @1,9,12:PRINT "Standing Charge* 
1530 AT #1,9,38:PRINT *£°3SChge/100; * (units @ ";UChge;"p)" 
1540 PRINT 

1550 PRINT 

1360 PRINT 

1570 PRINT #6," £°5x + (SChge/100) 
1580 CLOSE #5 

1590 cue 

1600 INK 4 

1610 END DEFine Now 

1620 REMark #£8S¢E2EE2 525852 E8F 5555442442 85444 
1630 DEFine PROCedure NU 

1640 LOCal f,q,h,i,j$,1,0,n$ 

1650 CLS:CLS #0 

1660 DELETE fip!_newtest file 

1670 OPEN_IN #4, FLPI_test file 
1680 OPEN_NEW #7, flpi_newtest_file 
1690 REPeat log 

1700 INPUT #, f 

1710 INPUT #4, g 

1720 INPUT #, h 

1730 INPUT #4, i 

1740 INPUT 86, j$ 

1750 PRINT 47, f 

1760 PRINT 87, g 

1770 PRINT 87, h 

1780 PRINT 87, i 

1790 PRINT #7, j$ 

1800 IF EOF(#5) THEN EXIT log 

1810 END REPeat log 


1820 CLOSE % 

1830 PRINT\\\" Last reading was "lg 
1840 INPUT® What is present reading ? "!k 
1850 PRINT\" Enter time & date (hh:am Dt Mas Day)" 
1860 PRINT\® , e.g. 09:00 09 Jul Thu" 
1870 INPUT" —> "!n$ 

1880 1 =k -gq 


1890 a = INT(] # UChge)/100 

1900 PRINT #7,9 

1910 PRINT 87,k 

1920 PRINT 87,1 

1930 PRINT 47,2 

1940 PRINT 87,n$ 

1950 CLOSE #7 

1960 DELETE FLP1_test_file 

1970 COPY flpi_newtest_file TO FLPi_test_file 
1980 seelog 

1990 END DEFine WU 

2000 REMark S#E8SSSES255505854252052525452901544 
2010 DEFine PROCedure seelog 

2020 LOCal a,b,c,d,e$ 

2030 CLS:CLS #0 

2031 REMark 123456789 123456789 123456789 123454789 123456789 123456 


2040 PRINT\® Last this Units Cost of Tiae 
& date* 

2050 PRINT © reading reading used units used of 
reading” 

2060 PRINT "-------------------------------------------------------- 


2070 OPEN_IN #9, FLPi_test_file 
2080 OPEN #10, SCR 440x156a50x55 
2070 REPeat viewlog 

2100 INPUT 89, a 


2110 INPUT #9, b 

2120 INPUT #9, c 

2130 INPUT #9, d 

2140 INPUT 89, e$ 

2150 PRINT #10, a,b,c,,"£"3d,,e$ 

2160 IF EOF(89) THEN EXIT viewlog 

2170 END REPeat viewlog 

2180 CLOSE #10 

2190 CLOSE #9 

2200 cue 

2210 END DEFine seelog 

2220 REMark S#ESSEEEESESEESESTEETESEEES ELSE ES E44 
2230 DEFine PROCedure look 

2240 LOCal a,b,c,d$ 

22580 CLS:CLS #0 

2260 OPEN_IN #5, flpi_meter_file 

2270 INPUT 45, 
2280 INPUT #5, 
2290 INPUT #5, 
2300 INPUT #5, d$ 

2310 INPUT #5, za 

2320 IF EOF(#5) THEN 

2330 e = 0: f = 0: g = 0: h$ = *-- date unknown"; ze = 0 

2340 60 TO 2430 

2350 ELSE 

2360 INPUT #5, e 

2370 INPUT #5, f 

2380 INPUT #5, 9 

2390 INPUT #5, h$ 

2400 INPUT #5, ze 

2410 CSIZE O,1:AT 91,2,32:PRINT “last Bill |! "sh6¢4 TO)!*Bill* 
2420 CEIZE 0, 0cAT 01,6, SiZPRINT S<VOtterrr er eeeeeewesee 


Co ao ow 


2430 AT 81,7, 14:PRINT “Reading was ut all 

2440 AT #1,8,44:PRINT "!° 

2450 AT 91,9, 14:PRINT “Units used were ass eB 

2460 AT $1,10,44:PRINT *!° 

2470 AT 1,11, 14:PRINT "Cost of Units zacie. | Ss 

2480 AT 81,12, 14:PRINT "Standing Charge £*3zaz" | £"3ze 

2490 AT #1,13,36:PRINT °--------!-------" 

2500 AT $1,14,14:PRINT “Bill total £°3¢ & zay” tS Sy ¢ ze 


2510 AT #1,15,44:PRINT *!° 

2520 AT #1,16,30:PRINT “as at*!d$;" !' as at"'hs 
2530 CLOSE #5 

2540 cue 

2550 END DEFine look 





Hyperriecio 





New for Pointer Environment programs, on-screen 
Help is sampled by Bryan Davies 


INFORMATION 

Program: HyperHelp for Basic 
v7.07 

Price: DM/49 plus DM7183 post & 
packing 

Supplier: Jochen Merz Software 
Develooment Im stillen Winkel 
12 D-4100 Duisberg 717, 
Germany, Tel/fax (01049) 203 
501274 (from UK) 

ana’ 

Price: £29 (inclusive) 

Supplier, Software&7, 33 
Savernake Road, London NW3 
2NU, 


Th QL User Guide has 
CO isker its share of 
criticism, for containing errors, 
not containing enough informa- 
tion, being too large, etc, and it 
is more than possible that many 
users do not ever bother to 


open it This is a pity, because 


(4 Ss Fi Help About ..: 
E CLERF 
CLO 
CLOSE OATE © 
CLS DAE 
CODE DEH 
CONTINUE COEF ine 
COF’ DEG 


HyperHelp may not appeal to 
you. Read on, even so, 
because you might be per- 
Suaded to give it a try. 


On-line 


HyperHelp provides on- 
screen help for SuperBasic 
functions (in the wide sense, 
not just with a capital F). It 
works under the Pointer 
Environment and can be 
loaded concurrently with other 
jobs, making it a usable refer- 
ence tool while you are pro- 
gramming. It is designed to be 
“aware” - to work with other PE 
programs, such as the QD 
Editor from the same stable. It is 
also user-adaptable - you can 
add to, and alter, the text sup- 
olied with this program. 

Something a little startling if 


=HyperHelp BASICS wQit ti = & 
DATHALIE « 
CHTER (3 


QIF_SELECTE  ERF_LEF +s 
Cy! EFF _OF «> 
CLINE 3 a 
OLIST ERP LENG 
CHEST ERF_FE«: 
Oi EFF _FF ' 

CIF EFR_]ue 


f lp1_BASIC_HELP_CIRCLE ===} 


ARC will draw a circle for an ellipse at a specif 
~ spec e Fs =Keainine an 


attached to the default c 
PIFCLE ute: the graphics coc be : 
(1.28. relative to the graphics origin, ¢ 
to the graphics cursor). For relative c 


Multiple circles op 


Each set of parameters mutt be separated tra 


; Ta cha f | 


ellipse: can be plotted with a single call to CIRCLE. 
ioeach other with & ztemicaionm oy). 


The werd ELLIPSE can te subetituted for CIRCLE 'f required. 


sunitax: = 43> numer ic_lexprets ton 


Ws= numer ic_espress ion 
radi = nUHer eo _ ea press bon 
eccentricity: 


his program lists 338 of these; 
how many of these do not have 
help text available would take 
too long to count, but a check 
on two screen columns - cho- 
sen at random - revealed 28 out 
of 36 functions without explana- 
tions. While some of the listed 
functions are unlikely to be used 
by most programmers, an 
average user may well make 
use of functions such as 
EXTRAS, and that is one of 
those which do not have 
details. (It is the Toolkit com- 
mand for listing the loaded 


MUM WC_LeS press Lon 


tram Boy. om: 





explained, and that is what most 
users will presumably want As 
you acquire additional functions, 
whether with hardware such as 
the Gold Card or software such 
as Professional Publisher, you 
can type in help details for them. 
As supplied, the program disk 
contained over 120 help files, 
the philosophy being that it is 
better to have a modular struc- 
ture for help rather than one big 
file, because it is then easier to 
make changes and additions 
with an ordinary text editor. It 
was also considered easier to 


4 [EUTTON_MATT ) CO’ _H OEL _OEFE: Et 

oF COF_H DELETE EQIT 
COPY_O QEST_USE ELLIF2E 
COS DESTOP ELLIFSE_F 
POT es DEW LIST ELE 
CSIZE DEW_HEST © ELIF #3 
CURCTS DEW USE ERLIN') 


EFR_HU ' 
ERR _NF 
EFF_LNI © 


SuperBasic functions, includ- 
ing add-on toolkit ones, to the 
screen). More surprising, since 
Merz products tend to be the 


provide links to other programs, 
to make help available from 
within them, if lots of small files 
were‘ used, Another factor is that 


EFR_HIG 
i 
ERR _OnN«) 
ERR_OR «) 


@ CHAR_USE 
@ CHEDO 
+ CIRCLE 


# CIRCLE_F 
¢ CKEVOFF 
+ CEEVON 

+ CLCHP 


CURSEH 
CURSOR GIN 
(ATH DINH® 
DATA_USE OIF 


the book really is not all that bad, 
and could answer many queries. 
The fashion these days, though, 
is to have “on-line help", informa- 
tion right before you on the 
screen, and - hopefully - relevant 
to your current problem. As with 
other aspects of computing, 
there are at least two schools of 
thought concerning on-line help, 
and you may be of the school 
which simply does not like this 
kind of thing, in which case 


DEW USER 


ERM 
ERR_ELO 
ERP _BH «> 
ERP_BO«) 


ERR _ Oe) 
ERR RG 
ERR_TE«) 
ERR_LSF Go 


ee ee Pe a SS Pe Se 





you are not expecting it is that 
there are quite a few items listed 
on the HyperHelp screens that 
do not have any information dis- 
played for them, leaving gaps to 
fill in from the start This is not a 
major criticism, as there are now 
a large number of functions, and 
Jochen Merz cannot be expect- 
ed to have traced all of them. He 
says that there are 500-600 
functions used in the QL, and 


tyoe which are bought by 
QPac users, is the lack of 
explanations for functions 
such as HOT_PICK(), 
HOT_STUFF and 
HOT_THING(. 


Functions 


The first screenful you see 
when HyperHelp is called upon 
is shown in Figure one, It can 
be seen from this sample that 
the index contains functions 
from a variety of sources, and 
you may not have heard of 
some of them. The standard 
SuperBasic functions are 


searching for a particular item in 
a large file could slow. The files 
are typically less than 1 KB in 
size. 

The help information does not 
need many words, in most 
cases; the QL User Guide 
descriptions are mostly brief. 
HyperHelp is not meant to pro- 
vide a beginners’ guide to 
SuperBasic, but as a reference 
source for users who Nave a 
working knowledge of it, howev- 
er limited. Figure two shows 
what is displayed on the screen 
for the functions CIRCLE, CIR- 
CLE_R, ELLIPSE and 
ELLIPSE_R. Where possible, 
several functions have been 
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covered on single screens, such 
as this one. When no informa- 
tion is available, you get the 
comments shown in Figure 
three. 

New data can be entered in 
different styles to suit the user's 
purposes. You can load the help 
files into word-processing pro- 
grams, such as Quill, Text87 
and Perfection, or text editors 
such as The Editor or QDS. 
Figure four shows the file 


lem, but is rather time-consum- 
ing. Help is obtained by clicking 
the right mouse button, or 
pressing Enter, with the pointer 
over the HyperHelp button, 
dragging the pointer by mouse 
or keys until the desired function 
is enclosed by a box, then 
oressing Enter again. Space 
scrolls the screen by one line at 
a time, and Enter by a page. 
Operations are what exper'- 
enced Pointer Environment 


ro SSSsSSSSSSpipt pastc_HELP_HELP_Txt == 


S=—==SS3S>sHs>> 
Ps 3. 
Sorry, me helpoon thes cubpect MUUCPIINEETELEUUEIErEErr gy 


anl, SERN ENR 


Tou can get general help oon 


the fil Lowi py 


subjects: 


=~ Opera tors Cmeithencatical , logical, =tr ings 


- Comparison rules 


Basic_HELP_CIRCLE loaded 
into Perfection; compare this - 
with the same data, as displayed 
on the screen, in Figure two. 
When creating a new help file, 
add a reference to that file in the 
index, Basic_HELP_INDEX. 
Other Merz programs will be 
supplied with Basic. HELP_ 
INDEX_ADD, covering new func- 
tions as well as those already in 
HyperHelp. The user can load 
the basic index file into an editor, 
then append the _ADD index file 
to the end of it; the whole file 
can then be sorted and edited, 
to order everything and remove 
duplications (if any). Other pro- 
grams will also have their own 
help files, to be copied to the 
HyperHelp file directory. To get 
help on a specific function, point 
to it on the screen with the 
mouse pointer, then press F1. 


Keyboard too 


A mouse is desirable, but, like 
most Pointer Environment pro- 
grams, not essential. Albin 
Hessler’s SERMouse was used 
during this review, and worked 
flawlessly, Moving the pointer 
with the cursor keys is no prob- 





users would expect, and are 
quite easy to understand for 
other users, Ctrl-C switches 
from HyperHelp to another pro- 
gram; when you switch back, 
the screen display is as you left 
it, so that you can put new help 
text on the screen and toggle 
quickly between it and the pro- 
gram you are writing. 

When you have had a Gold 
Card fitted for a year or so, you 
tend to forget what life is like 
with a basic QL, but there is no 
reason to think HyperHelp | 
would be in any way unaccept- 
able - as far as speed is con- 
cerned - on the basic machine. 


_ However, the program 


and extensions take a fair 
amount of space, plus 
the Help files; you proba- 
bly won't be able to load 
the latter into a ramdisk 
on a basic QL The 
review was done with the 
files left on disk, and the 
speed of access was 
quite acceptable. The 
drive used however was 
an ED (extra-density) one, 
which has a much better 
access time than DD or 
HD drives. The program 
defaults to searching the 
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FLP1_Basic_HELP_ directory for 
help files, but it can be config- 
ured to look at any standard QL 
device. The ideal would be to 
have the files installed on a hard 
disk drive, and copied to 
ramdisk when the system is 
booted. You could keep the help 
disk in FLP2_ if programs and 
development tools are kept on 
disk in FLP1_. With ED drives, 
the greater storage capacity 
makes it much easier to keep 
everything on single disks, of 
course. 


The instructions supplied 
with the program are on five 
sides of AS paper, well-printed, 
and well-written. There is no 
need for more, since the pro- 
gram is so easy to use. 

The program disk contains 
files in both German and 
English, as usual with Merz 
Software programs. The Merz 
“house style” is familiar to me, 
but some buyers might be 
confused by the file names on 
the disk, and the instructions do 
not explain them. Various pro- 
gram files have _ENGLISH as 
part of their names; likewise, the 
file names for the individual help 
files are English, and these are 
the ones to copy to your work- 
ing disk for help displayed in 
English. The supplied boot rou- 
tine will load the German ver- 
sion unless you change the file- 
name of the program itself (from 
HyperHelp to HyperHelp_English) in 
the boot, or rename the two files 
themselves. 

The program requires roughly 
120 KB of memory to run, Over- 
all (this figure is not quoted in 


ARC with pegs eg 
mttached te the default or 
RIRCLE uses the graphics 


iCi,e, relative to the : 


Memory needs 


cirncle (op an ellipse at a specifi 
i | 


the instructions, but is the differ- 
ence in free memory values 
before and after the program 
was loaded). If you do not have 
the Pointer Environment already 
on your system boot disk, you 
need about 35 KB of this for the 
files PTR-GEN, WMAN, and 
HOT_REXT. The program's own 
PE extensions file MENU_REXT 
requires over 20 KB. The help 
files, loaded into ramdisk, require 
about another 140 KB (but you 
can omit any functions that do 
not matter to you). You may well 
have other extensions loaded, 
for application programs, and/or 
for hardware devices; for exam- 
ole, The Editor requires 5-10 KB 
of extensions, the Miracle hard 
disk drive requires around 50 
KB. Clearly, you cannot put all of 
this on a basic, un-expanded QL. 


Conclusions 


HyperHelp is just the kind of 
thing relatively-inexperienced 
SuperBasic programmers could 
use. In fact, many non-program- 
mers would appreciate a quick 
reference facility for odd toolkit 
commands. It is not suitable for 
QLs without memory expansion. 
A good structure, with reference 
data which is easy to extend. 
Average users should find no 
great difficulties, either in setting- 
up the program for their particu- 
lar system configurations, or in 
adding their own help text | felt 
let down in the version reviewed 
by lack of help on quite a lot of 
fairly common functions. Merz 
Software has undertaken to cre- 
ate compatible help files for all 
its Own programs, given time. 
The price is reasonable. 
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Simon Goodwin crafts a Mouse Organ in Amiga SuperBasic 





rare to 
4 find 

music 

dis- 


cussed in QL World. The QL 
BEEP function is rather eccen- 
tric and other approaches - like 
MIDI and net sound - have 
made little impact. But the 
Amiga Qdos emulator has 
access to impressive sound 
facilities, and it is surprisingly 
easy to use them from 
SuperBasic. 

This month's SuperBasic in 
Action project generates accu- 
rate polyphonic stereo sounds 
controlled by the mouse. It 
uses new PTR_ keywords intro- 
duced in Amiga Qdos 3.20, 
and direct access to the 
Amiga’s sampled sound hara- 
ware. Unlike QL sound, you can 
control hardware filtering and 
edit the waveform and hence 
the timbre of the music. 

Even if you do not have 
access to an Amiga, the pro- 
gram is interesting as it calcu- 
lates musical intervals more 
precisely than the ‘even-tem- 
pered’ keyboard of pianos and 
other instruments, which are 
tweaked away from pure ratios 
to allow them to harmonise 
acceptably, but not exactly in 
any one key. Computers can 
generate more exact chords in 
all keys than such antique 
hardware, and it's a pity that 
most programmers stick to the 
twelve note chromatic scale 
when they have access to so 
much more. 


Beethoven is . 
spinning in his 
grave 





| shall discuss music from 
first principles, with a few refer- 
ences for those with a knowl- 
edge of music. I'm grateful to 
Miles Walsh and my brother 
Sam for theoretical insights, 
Sounds and notes consist of 
repeated waves. Their frequen- 
cy or pitch increases as their 
‘wavelength’ decreases, and the 
waves arrive closer together. 
Chords are combinations of 
notes, generally those that beat 
together harmoniously, gener- 
ating interference patterns 
characteristic of the ratio of 
their frequencies. The waves fit 
together neatly and the combi- 
nation of notes sound ‘in tune. 
When the higher note has 
twice the frequency of the 
lower one, the notes are said to 
differ in pitch by an octave. So 
universal is the eight-note scale 
in western music that the inter- 
val between one note and the 
one at double its frequency is 
always called an “octave’, even 
when other divisions are used. 
Most western music divides 
the octave into twelve steps of 
one “semitone” along the piano 
keyboard in black and white 
notes, The thirteenth note, 
“eighth” or “octave” begins the 
pattern again at a higher pitch. 
Other pairs of notes use differ- 
ent ratios - for instance a gap 
of seven semitones on a piano 















































REMark Amiga Qdos STEREO TONE GENERATOR 
1010 REMark Uses 8 chip RAM bytes. Version 6 
1020 REMark By Simon N Goodwin, 7 July 1993 
1030 REMark Uses HEX, ALCHP, RECHP, SYSBASE 
1040 : 

1050 REMark Pentatonic musical constants 
1060 root=2%(1/53) 

1070 note2=root’9 

1080 note3=root’17 

1090 note4=root’31 

1100 note5=root’39 

1110 DIM note%(39) 

1120 here=28800:REMark Or 25920, or 32767 
1130 FOR i=39 TO 4 STEP -5 


1140 note%(i)=here 

1150 note%(i-1)=here/note2 
1160 note%(i-2)=here/note3 
1170 notez%(i-3)=here/note4 
1180 note%(i-4)=here/note5 
1190 here=here/2 


1200 END FOR i 
1210 °$ 

1220 REMark Limit of chip RAM 
1230 chip_top=2*21 

1240 REMark Hardware register labels 
1250 pra =HEX("BFEOO1") 

1260 dmacon =HEX("DFFO96") 

1270 adkcon =HEX("DFFO9E") 

1280 audOlc =HEX("DFFOAO") 

1290 audOlen=aud0lc+4 

1300 audOper=aud0lc+6 

1310 audOvol=aud0lc+8 

1320 audlilc =aud0l1c+16 

1330 audllen=aud0len+16 

1340 audlper=aud0per+16 

1350 audivol=aud0vol+16 

1360 : 

1370 REMark Find some chip memory 
1380 chip=ALCHP(8) 

1390 fast_ram=(chip>=chip_top) 
1400 IF fast_ram 


1410 RECHP chip 
1420 REMark Grab workspace beyond Qdos tables 
1430 chip=PEEK_L(SYSBASE+124) 


1440 END IF 

1450 REMark Prepare simple wave table 

1460 RESTORE 

1470 REMark DATA ~-126,-90,-54,-18,18,54,90,126 

1480 REMark DATA 127,127,127,127,-127,-127 ,-127 ,-127 
1490 DATA 0,90,127,90,0,-90,-127,-90 

1500 FOR i=chip TO chipt+7 

READ x : POKE i,x 
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1520 


END FOR 1 


1530 : 


1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 


1630 : 


1640 
1650 
1660 
1670 
1680 
1690 
1700 
£710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 
1830 
1840 
1850 
1860 
1870 
1880 
1890 
1900 
1910 
1920 
1930 
1940 
1950 
1960 
1970 
1980 
1990 
2000 
2010 
2020 
2030 
2040 
2050 
2060 
2070 
2080 
2090 
2100 
2110 
2120 
2130 
2140 
2150 


2160 : 


2170 
2180 
2190 
2200 
2210. 
2220 
2230 
2240 
2250 
2260 
2270 


POKE_L audOlc,chip 

POKE_L audilc,chip 

POKE_W audOlen,4 

POKE_W audilen,4 

POKE_W audOper,789 

POKE_W audiper,789 

POKE_W audOvol,64 

POKE_W audivol,64 

POKE_W adkcon,255 :REMark No modulation 


HELLO : POINT 
AUDIO_ON 1+2 : 
REPeat sing 

POKE_W audOper,note%(PTR_X% DIV 6) 

POKE_W audiper,note%(PTR_Y% DIV 6) 

k$=INKEYS : IF k$="_" : EXIT sing 

IF k$="#" : cutoff=NOT cutoff : FILTER cutoff 
END REPeat sing 
AUDIO_OFF 1+2 
IF NOT fast_ram 
CLS. #0 : PTR_OFF 
STOP 


cutoff=0 


: RECHP chip 


DEFine PROCedure POINT 
PTR_LIMITS 0,0,239,239 
PTR_POS 120,120 
PTR_INC 1,1 : PTR_ON 
END DEFine POINT 


DEFine PROCedure HELLO 
REMark Display note grid 
OPEN #3,scr_480x240a0x0 
FOR j=6 TO 239 STEP 6 
pen=3 + ((j MOD 30)=18) 
BLOCK #3,2,240,j*2,0,pen 
BLOCK #3,480,1,0,j,pen 
END FOR j 
REMark Overlay instructions 
CSIZE #3,2,1 : OVER #3,-1 : INK #3,7 
PRINT #3,\," AMIGA QDOS SOUND DEMO"\\ 
INK #3,4 
PRINT #3;" Move the mouse to play a stereo sample" 
PRINT #3 \\ 


: CLS #3 


PRINT #3;" Top left gives highest pitches"\\ 
PRINT #3;" Bottom right for lowest pitches"\\ 
PRINT #3;" Press any key for silent SuperBASIC..." 


CLOSE #3 
END DEFine HELLO 


DEFine PROCedure AUDIO_ON(x) 
REMark X =1, 2, 4, 8 for channels 1-4 on 
IF x>0O AND x<16 
POKE_W dmacon,x-32768 
END IF 
END DEFine AUDIO_ON 


DEFine PROCedure AUDIO_OFF(c) 
REMark Turn off audio channels 1, 2, 4, 8 only 
IF 1<=c AND c<=15 
POKE_W dmacon,c 
END IF 
END DEFine AUDIO_OFF 


DEFine PROCedure FILTER(flag) 


IF flag 

POKE pra,PEEK(pra) && 253 
ELSE 

POKE pra,PEEK(pra) || 2 
END IF 


END DEFine FILTER 


DEFine FuNction SYSBASE 
RETurn 163840 
END DEFine SYSBASE 
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keyboard comes close to a 
ratio of 3:2, another pleasing 
beat known to musos as a ‘fifth’ 
(the first and fifth note of the 
usual scale). 

To understand Western 
music theory you have to 
remember that a normal scale 
has twelve notes of which eight 
are normally used in any one 
key. The twelve notes start to 
repeat on the thirteenth, but the 
eight notes start to repeat on 
the eighth. Clear as anything, 
isn't it? 

The twelve-note scale on a 
normal instrument is less accu- 
rate for other intervals, like 5:3, 
5:4 and 9:8, because it doesn't 
have enough divisions, This is a 
shame, as these ratios are 
common in both Western and 
Eastern music, and have mant- 
fold musical names. But don't 
be put off. All that matters is the 
ratio of the wavelengths. 

The twelve- (or eight-) note 
scale gets from one frequency 
to twice that in twelve equal (or 
eight unequal) steps, but you 
only need to stop at five of 
these steps to generate all the 
ratios | have mentioned. A five- 
note scale is known as a penta- 
tonic scale, and pentatonic 
scales are the basis of much 
ancient religious music and 
20th Century Blues. If you're 
struggling to play the finale 
from Pete Townshend's 
Quadropheria, try the black 
notes of the piano keyboard! 

(Start from D sharp, and you'l 
have the pentatonic, aeolian 
modal or Blues, whichever you 
like to call it version of a nor- 
mal natural minor scale. Start 
on one of the other black 
notes, and you'll have some- 
thing totally different as the 
step patterns will be in the 
wrong place. - triangle-playing 
Ed) 

This program plays pentaton- 
ic music in a two-note chord 
over an eight-octave range, 
based on a scale with 53 equal 
divisions instead of 12. Why 
53? Because that works partic- 
ularly well. You select the notes 
by moving a pointer across a 
grid with the Amiga mouse. 
Red lines separate notes in the 
scale, and green lines mark 
each octave. 


The highest notes sound 
when the mouse points at the 
top left corner. Move it to the 
bottom right for deep bass. 
Press # to switch on and off 
the Amiga’s filter, which cuts 
treble to make the sound less 
harsh. Press SPACE to stop the 
sound and return to 
SuperBasic. 

The interesting thing is the 
variety of chords you get by 
moving the pointer sideways, 
up and down. Diagonal posi- 
tions give the same pitch from 
each stereo channel, and the 
notes separate in a pleasing 
pattern as you move away from 
that line. 


How it works 


The program derives note 
wavelengths from an even 
scale of 53 notes, rather than 
the Western twelve-note scale. 
This would be unfeasible for a 
piano no-one has long-enough 
arms - but is no extra trouble 
for a computer. 

Line 1060 sets ROOT to the 
number which you have to 
multiply by itself 53 times to get 
2, sensibly known as the fifty- 
third root of two. Replace the 
value 53 with a temporary vari- 
able if compiling with Turbo or 
Supercharge, or the compiler 
will ‘optimise’ the integer 
expression 1/53 to zero, and 
all five notes will be the same. 
Oops. 

The next four lines pick the 
required ratios: 9, 17,31 and 
39 steps along the 53 note 
scale. If you use a twelve-note 
scale, use 3, 5, 7 and 10 and 
replace the 53 with 12. If it 
sounds better, you're hooked 
on convention. 

The array NOTE% holds 
ascending wavelength values 
for 40 notes. You may wonder 
why | don't just work out the 
ratios directly. The program 
evolved to allow easy experi- 
mentation with new scales and 
intervals while staying in touch 
with Earthly norms. The initial 
value 28800 was suggested 
by Sam because its factors are 
2,3 and 5, fitting the scales 
nicely without rounding errors. 


The pointer 


The Amiga hardware can 
move sprite images over the 
screen under program control, 
without disturbing the back- 
ground display. Amiga Qdos 
lets you turn on a sprite pointer, 
which subsequently moves 
around the screen under 
mouse control as your pro- 
grams run. 

The new functions PTR_X% 
and PTR_Y% return the position 
of the pointer within limits set 
by PTR_LIMITS. Co-ordinates 
range from O to 255 in each 
direction, like MODE 8 pixels. 
Line 1780 confines the pointer 
to an area of 240 units square, 
matching the grid window #8, 
opened in line 1850, Six units 
are allocated to each grid 
square, for 40 (240/6) notes in 
all. 

PTR_ON and PTR_OFF con- 
trol the pointer display, while 
PTR_INC lets you set the step 
for values of PTR_X% and 
PTR_Y%, lf moving over text in 
CSIZE 3,1 you might set 
PTR_INC 8,20 to use charac- 
ter-sized steps. 


The hardware 


ach Amiga sound channel 
has four ‘ports’, which can be 
programmed with POKEs, 
Lines 1250 to 1350 set stan- 
dard Commodore port names 
and addresses. Fourteen bytes 
control each channel. The first 
a long word, the address of the 
wave data that will be played. 

The other values are 16 bit 
words. Next comes AUDOLEN, 
the length of the wave, in 
words, 1-65535, followed by 
AUDOPER which sets the time 
period between waves, in units 
of about 280 nanoseconds, 
The minimum period, or top 
speed, is about 130 units per 
byte played - about 28 thou- 
sand samples per second - as 
the data gets transmitted while 
the display is not busy. - 

The next word controls the 
volume, from O to 64, so each 
channel has a 14 bit resolution, 
with 6 bits of volume control 
and eight bits of data. One 
word is unused; then come the 
registers for the next channel. 


The wave data must be 
stored in ‘chip memory’, acces- 
sible to the custom sound 


~ hardware. Most Amigas come 


with chip memory but you can 
add ‘fast memory later. If this is 
present QL tasks and heap can 
use fast memory, while the sys- 
tem occupies the first part of 
the chip memory. If ALCHP 
returns an address below two 
megabytes, Qdos is running in 
Chip memory and the space 
can be used. Otherwise we are 
in fast memory and need to 
look elsewhere. 

With Qdos running, my 3- 
megabyte Amiga has 2 
megabytes for Qdos code and 
data, and 800K of spare chip 
memory; the rest is used for 
disk track buffers, QL and 
Amiga screens, system code 
and variables, and the expan- 
sion ROM slot. PEEK_L(SYS- 
BASE+1 24) finds the start of 
this unused space. Amiga Qdos 
‘roms’ like the SER and PAR 
device drivers sit at the other 
end. The BOOT program on 
the Amiga Qdos 3.2 support 
disk includes code to load 
toolkits into spare chip memory. 
lf you use this, Mark J Swift rec- 
ommends CHIP=98688, 

SYSBASE, the first address of 
system variables, is always 
163840 on current Amiga 
Qdos systems. Ignore the last 
three lines of the listing which 
set up a Basic equivalent if you 


use the DIY Toolkit SYSBASE 


function. 

The hardware filter is con- 
trolled by an eight bit port, eco- 
nomically known to 
Commodore as PRA. Unlike the 
16 bit ports, you can read as 
well as write to this, so the pro- 
gram uses PEEK to read the 
old value before setting or 
clearing bit 1 to turn the filter 
on or off, 


Two more 


Only two more registers need 


be explained. DMACON con- 
trols Direct Memory Access, 
and the bottom four bits of the 
word allow the sound channels 
access to chip memory. The 
low byte of ADKCON controls 
special sound effects which 
combine channels. We POKE 


that to 255, to clear it without 
affecting the other bits, used by 
the disk system. 

How come 255 clears eight 
bits? The Amiga uses a neat 
scheme so you don't have to 
PEEK its word ports before you 
POKE individual bits. If bit 15 is 
set when you write to an Amiga 
word port, all the other set bits 
in the value you POKE get set 
in the register. Zero bits are 
unaffected. If bit 15 is zero, any 
set bits are cleared in the regis- 
ter. Again, zero bits have no 
effect. Thus you can whack the 
bit or bits you want without 
interfering with the others, 

POKE ADKCON with -32767 
or -32752 at line 1620 to hear 
Channel 1 modulating the vol- 
ume or period of Channel 2. It 
sounds weird unless Channel 
1 is much slower than Channel 
2, when you hear conventional 
analogue synth effects, 

The three DATA lines from 
1470 to 1490 describe square, 
sawtooth and rough sine 
waves. Eight bit sample values 
range from -128 to +127, and 
indicate the depth of the wave 
at successive points. Remove 
the REMark before the DATA 
you wish to use, and RUN the 
program to hear the new tim- 
bre. 

If you break in while the 
sound is playing, type 
AUDIO_OFF 3 to stop the 
sound. Channels are numbered 
1,2, 4 and 8 and these values 
may be used in combination, 
so AUDIO_OFF 3 turns off 
channels 1 and 2, the two used 
by this program. AUDIO_ON 1 
turns the first back on again. 
The direct commands FILTER O 
and FILTER 1 switch the hara- 
ware filter off and on, control- 
ling the brightness of the Amiga 
power light into the bargain. 


Further work 


Try other wave DATA for a 


new tone or timbre. Longer pat- 
terns allow a more accurate 
sine pattern, like a flute without 
the initial breath sound. You 
can use samples up to 128K 
long. Lines 1560 and 1570 set 
the sample length to four 
words. 

Increase the 4 to 12, replace 


7 with 23 at the end of line 
1500, to read all three DATA 
lines, and increase the ALCHP 
on line 1880 to 24 bytes. Now 
you can play all three DATA 
patterns in one wave. This will 
make all the notes deeper 
unless you tweak the initial 
wavelength set at line 1120; 
experiment near the bottom 
right corner, to hear - and even 
count - the beats between 
notes. 

Mathematicians and psychol- 
ogists can investigate the 
errors in chords for different 
scales. What is the next best 
number of divisions to set to 
get a mathematically perfect 
pentatonic scale? How does 
the wave pattern influence per- 
ceived pitch? 

lf you're more practically 
minded, why not write a 
SuperBasic procedure to emu- 
late QL BEEP? Start with just 
the first two parameters, and go 
on to the others when the pitch 
and duration match your QL 
You could use UNSET (from 
DIY Toolkit Volume Q) to 
check the number of parame- 
ters, and the Timer routines 
from Volume H for processor- 
independent timing. The QL 
waveform is a rough square 
wave, but you can probably find 
something more pleasant, if 
less accurate! 
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Easei - 


part 4 





Easy with 


Henry Orlowski examines the powerful design features inside Easel. 


April's issue we 


finished our 
graph design 
and examined 


the different formats in which it 
could be displayed. This time we 
will look at the fine tuning we 
can employ to change almost 
every aspect of the graph to put 
a personal stamp on it. 

Load up Easel and the graphs 
you saved previously, Make 
‘poys’ the current figures using 
the View or Olddata command if 
it is not the current set dis- 
played. 

The first bit of fine-tuning we 
will look at is to make certain 
parts of the graph stand out 
Change to format O, 1 or 2, the 
vertical bars. Looking at the bars 
it will suddenly strike you that it 
is notable that so many boys 
liked a cooked meal rather than, 
Say, a quick takeaway, Such that ° 
it was worthy of highlighting this 
result To do this, use the H for 
Highlight command. Then press 
the V for value option and select 
the cell whose value wants high- 
lighting. (You will have noticed 
that your other option is to 
select to highlight all negative — 
values, but this is not applicable 
in this case.) Next you are given 
the option to select a defined 
highlighted bar or you can even 
design your own (more on 
designing your own bars later 
on). Try a few different selections 
and see which is the best for 
the job. 

Now change to format 7 for 
the pie chart option. You will see 
what you would have got if you 
had carried out the same 
sequence of operations. In this 
case the segment is highlighted 
by detaching itself from the 
chart. 


Making Changes 


Now let's return to one of the 
vertical bar formats. You might 
consider that you dont like the 
look of the bars you've got You 
can change the colour and. 
even give them a border. 

Choose C for Change, then B 
for Bar. Easel then asks you for 
the number of the bar you want 
to change to. Of course, you 
won't know what corresponds 
to what, so instead of putting in 
a number in response, just 
press Enter at the ? prompt You 
will see displayed 18 different 
numbered bar types on screen 
for you to choose from. Use the 
cursor keys to move between 
bars, then use Enter to make 
your selection. Try a few out 

If you cant find one that you 
like, you can actually design 
your Own. TO do this select the ? 
bar option to put yourself into 
bar design mode. You now have 
a series of operations you can 
move between using the up and 
down cursor keys. Pressing 
Enter while on an operation 
allows you to make changes 
within that operation. The first is 
the bar colour. Use the cursor 
keys to move between the four 
possible options, and note how 
the diagram on the right 
changes to reflect the design 
choices you are making (of 
course, it helps to have a colour 
screen). 

Then you can select a border 
colour for your bar. This is the 
border around the bar itself, and 
again you have a choice of four. 
It might be best to examine the 
next option first, however; this is 
the border thickness and you 
should be aware that if your bar 
has no border then it means 
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that the border thickness is in 
fact zero, So changing the bor- 
der colour will not make any dif- 
ference, However, entering a 
border width will make any bor- 
der colour come into being. The 
border width is expressed as a 


Neal Preferences 


~ Takeaway 
d 


number between 1 and 100. 
Don't worry what its unit is, just 
try out a few different values and 
see what you get Once you are 
happy with your design combi- 
nation press the ‘satisfied’ option 
and all will be displayed, 


Tweaking text 


Moving further on, you might 
decide that the text style is not to 


HELP DES IGN 
Use tL to select design option 


your liking and you want it 
changed to make some text 
stand. This does affect the ‘title’ 
so enter some text like ‘School 
Market Research Project’ and 
position it where you like. To 
make changes to this text, use C 





Sandyich 
3 


for Change followed by T for 
Text. A number of options are 
then presented to you in the 
same way as with the bar 
design operation. 

The first is the text colour, fol- 
lowed by the background paper 
colour. This is not the colour of 
the whole graph but the area 
immediately behind the text in 
question. The next option is to 
choose a transparent back- 


COMMANDS 
“é3 





PROMPTS 
F2 


os ia 


Fill colour 


commeand> Change to BAR ? 
=ormat 8 Rap BAR 3 
Tyrrant Name girls 


and press ENTER. Use ¢% to 
select colours then ENTER 


F6 


Task gruphs 
786K Memory 





ground paper, in other words, 
the same as the graph paper 
background. If you want this 
option you will notice that it tog- 
gles between on and off every 
time you select it If on, the back- 
ground paper colour is ignored. 
Lastly, you can select a text 
direction which toggles between 
vertical and horizontal each time. 
Why not choose ‘vertical’ to 
make it stand out from the title of 
the graph? When happy with 
your selection press ‘satisfied’. If 
you don't like what you see, try 
again. 

There are still a number of 
additional options available to us 
to change the appearance of 
our graph further. The major 
area of the graph is usually the 
graph paper itself, the area 
which is currently made up of 
the background grid on a paper 
colour you can see on the dis- 
play. 

To change this use C for 
Change followed by G for 
Graph. You will see a display of 
seven graph styles for you to 
make a preference. Alternatively 
you can design your own, so 
why don't you do so. Accept the 
? to get into design mode. You 
navigate between the options 
and make your selections as 
before with the bar and text 
change operations so | won't 
repeat it Suffice to say that you 
now have the ability to design 
the paper colour and the grid 
colour by following the indica- 
tions displayed to you. 
Experiment a little. It's the best 
way to grasp it If you don't like 
your design when you sée it in 
all its glory then try again until 
you're happy. 


Axis and label 


We're not finished yet You can 
also change the style of your 
graph’s axis design. To do so 
you must use the Change com- 
mand as before, this time with A 
for Axis. Try it and select one 
from the 10 styles shown. Or, 
design your own. The design 
option lets you come up with 
your own combination of axis 
and label colours, axis limits (the 
low and high values of your axis) 
or even whether you want the 
axis lines drawn or not As 
before try a few combinations 


and see how they look. 

Lets now look at a further 
option. Change to format 3 or 
4 depending on your version 
of the program, which is the 
line graph format Line graphs 
are best for displaying trends, 
but we are experimenting. 
What we will do now is 
change the style of the line, A 
number of possibilities are 
available. Use the Change 
command again but this time 
select L for Line. You can now 
give a line style number, which 
you won't be able to do 
because you are not familiar 


with the options, or accept the ‘“?. 


This gives you a display of 16 
possibles to choose from. Or 
you can design your own, Let's 
design our own. Move to the “? 
and Enter. 

You are now presented with a 
number of design options for 
you to consider. Firstly you have 
the choice of four line colours 
for you to select one that looks 
the best Then you can choose 
whether to display a symbol or 
not. The symbol means a small 
marker to denote the position 
of each point on the line. 
Thirdly, you can choose the 
colour of the symbol, out of 
four possibilities, and then you 
can have your line ‘filled! if 
required, This option gives you 
a range of mountains rather 
than just a line and serves to 
give a sense of power or 
importance to the values it 
represents. If, for example, you 
are displaying two sets of fig- 
ures, one of which is a set of 
actual values while the other is 
the minimum acceptable below 
which you must not go, then our 
mountain range filled line could 
be used to represent the critical 
base. And finally you can 
choose the thickness of the line 
itself within a range of O to 100. 
Again the best thing to do Is to 
experiment and see what com- 
binations you can come up with. 


Shades of grey 


| think you will agree that the 
sheer scope for customising 
your graphs is limited only by 
your imagination. As always you 
should bear in mind that what 
you end up with on your moni- 
tor will not be accurately repro- 


SELECTION 


HELP 


PROMPTS 
F2 


Nave the box cursor with the ¢ % 
keys and press ENTER. For a 
new design selact the last ¢?), 


F3 
F6 


EASEL Bars 


Your Bars 


command> Change to BAR ? 
Format @ Rep BAR 3 
Current Name girls 


duced when you print it out A 
mono printer, as most of us 
have, will only produce shades 
of grey to represent different 
colours, and even a colour print- 
er may have difficulty in differen- 
tiating all the different colours 
you wish to have produced. The 
important thing is to produce 
something that has your own 
personal stamp on it, and that 


Task graphs 
7@6K Memory 





sets of figures, which you speci- 
fy separated by commas, yet 
retains all your settings, includ- 
ing all your design work So if, 
for example, you conduct a simi- 
lar survey at another school, you 
can just enter the new results 
into the same basic graph set- 
Up. 

Zap Is different because it gets 
you back more or less to the 


Neal Preferences 


Cooked 


you should now be familiar with 
the enormous range of func- 
tions that Easel can offer to cre- 
ate new and original offerings 
for a range of potential uses, 

Always remember to S (Save) 
your masterpieces for future call 
up so that you can retrieve them 
at any time. Once you've got 
your graphs safely tucked up in 
their disk or microdrive file, and 
you want to create a new graph 
of some sort, then you can 
either K (Kill) or Z (Zap) your 
existing sets of figures held In 
memory. 


Kill and Zap 


If you use K for Kill it deletes 
all your data from one or more 


| “Tokeauay 
Tupe of Neal 


Sonduich | “Shocks 





Original basic graph layout you 
are presented with when you 
first load up Easel. This includes 
the original horizontal axis labels, 
Jan to Dec. 

lf you want to leave Easel alto- 
gether for now then use the Q 
for Quit option. 

Finally, | would like to thank 
you for following this series of 
articles. | trust you have found it 
enjoyable and informative. My 
aim was to make you aware of 
Easels potential for everyday 
applications in addition to the 
more obvious business ones, 
and if I've made you stop to 
think about it’a little then | have 
been on the right road, Stay with 
it a little longer - its an opportu- 
nity not to be missed. 
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Data- 
DESIGN | 5 — 


Wolfgang Lenerz has been using and commenting on the new DataDesign. 


The database market 


for the QL isn't really saturated. 
Apart from the ubiquitous 
Archive, the only serious 
contender was Flashback, which 
had the advantage of being 
faster, but could not be 
programmed, and its report 
generator left much to be 
desired. Now -there is 
DataDesign, a database 
management system for the QL 
programmable in ‘C’, Basic and 
Assembler. 

Perhaps | should set out right 
from the start that | have been 
slightly “involved” in this program 
as a beta tester. Having said 
that, | have no connection to 
Progs, the authors, other than 
being a (difficult to satisfy..) user 
of their program. It is probably 
due to the fact that | didn't stop 
bombarding them with 
suggestions that they asked me 
to beta-test version 3 of their 
programs. On the other hand, | 
can witness their willingness to 
listen to users, and make 
reasonable amendments/ 
additions. Progs’ after-sales 
service leaves nothing to desire! 
| do admit, however, that | am 
really taken by this software, 
which | find very powerful. 


More friendly 


DataDesign 3 is (you might 
have guessed) a successor to 
DataDesign 2, a moderately 
successful database 
management system (DBMS) on 
the QL To exist next to Archive, 
which comes free with every QL 
a DBMS must be faster, more 
powerful and more friendly than 


its eternal rival. | find that 
DataDesign is. The interesting 
thing about DataDesign is that it 
comes in three parts: first, there 
is the database “engine”, the 
part that actually handles all the 
data. This is the most important 
part of the system. Second, there 
is a badly-named ‘Main 
program’, which is actually a 
front end to the engine, allowing 
easy access to the engine and 
the data. Most users who are 
not programmers will use this 
front end to access the 
database. Finally, there is the 
“Application Programmers 
Interface” (API). This is the 
description of how you can 
access the database from within 
your Own programs, enabling 
you to program the engine 
directly. 

This means that DataDesign 
will be suitable at the same time 
for those who want a simple, no- 
hassle, cardfile-type database (a 
la Flashback), and for those who 
want to write fully-fledged 
database applications. Also, as 
both are sold separately, you 
can buy only that part which you 
really need. | shall concentrate 
first of all on the engine itself, 
then on the front end and finally 
on the API. 


The engine 


The engine is the very heart of 
the DBMS. It is through this that 
you access the data, add to it, 
delete from it, filter or sort it, ete. It 
is also the engine which 
determines whether a database 
is fast, how many records can 
be used, how the database is 


Organised and so on. The 


distinction between the engine 


and the “front ends” exists in 
nearly every database (even in 
Archive). DataDesign is special 
in that the distinction between 
the engine and the various front 
ends is made quite clear. The 
DataDesign engine has two 
fundamentally different ways of 
handling files: files can be disk- 
based, or memory-based. The 
disk-based approach is that 
used by Archive: all the data, 
except for a few records, 
remains on the disk and is 
loaded only for displaying (or 
selecting, sorting, etc). The other 
way of handling data, which can 
also be implemented in 
DataDesign, is to load all 
records into memory right away 
and keep it there until one quits 
the program. 

Both methods have their 
advantages and disadvantages: 
leaving the records on the disk 
will slow down access to the 
data, as it will have to read from 
the disk each time it is to be 
accessed. Having the data in 
memory makes access to it is 
so much faster, On the other 
hand, in theory a disk-based 
database is safer: if the 
computer crashes, only one 
record should be corrupted, that 
currently being updated and 
which hasn't been saved yet. In 
a memory-based database, 
unless the data is explicitly 
saved after each modification, it 
will all disappear if the computer 
crashes (as has been known to 
happen to the QL!). In this, 
Archive is not typical, because it 
has both disadvantages: it is 
disk-based, and slow, but if the 
computer crashes with the file 


still open, you still lose all your 
data. They got it wrong there! 

This does not happen with a 
disk-based file in DataDesign, 
where at the utmost you lose 
only one record (the one in 
memory, or the one being 
written out to the disk). 
DataDesign is noticeably faster 
than Archive even in disk-based 
mode. 


Memory size 


The DataDesign engine also 
accepts that a file can be 
memory-based, increasing yet 
again the speed of access. Of 
course, when a file is memory- 
based, all data is held in 
memory, so that, with a large 
database (over 700 KB, as are 
some of mine), one might need 
at least a Gold Card. 

Like every other database, 
DataDesign is organised in 
records, each record containing 
a given number of fields. 
According to the documentation, 
DataDesign has no limit on the 
number of records it can handle, 
except for memory: in a 
memory-based database, the 
number of records will depend 
directly on the amount of data 
contained in each record. For a 
disk-based file, each record 
takes 18 bytes of memory at 
least (this can be more, if 
different indexes are used; see 
below). Here the power of 
DataDesign becomes apparent, 
as it is possible to switch 
between disk-based and 
memory-based. operations at 
any time! If a memory-based file 
becomes too large, one can 


make it disk-based, and 


continue working on it. 


diASO FRBHZIGE UP ISHS 
fields per record. That should be 
enough for most of us. If not, it is 
possible to sub-divide each field 
into lines and, of course, access 
each line independently. 
Moreover, the lines of the fields 
have no imposed maximum 
length, they are as large as the 
data put into them. This, 
combined with the fact that 
DataDesign accepts “raw” fields 
(which have no deteremined 
type and can be used, for 
example, for images) means that 
DataDesign is a free-formt 
database. At the same time, the 
DataDesign engine allows You, 
should you so wish, to give a 
determined type to each field - 
the allowed types are: raw 
(anything), string, integer (2 
bytes), long word (4 bytes) and 
IEEE double (8 bytes). 


Concerning the fields, a 
significant difference with 
Archive can be seen: it is 
possible, at any time, to add (or 
delete) a field! This is not 
possible with Archive where one 
has to create a new database 
containing all of the old fields as 
well as the new one, and then 
copy all the data across. 

The. DataDesign engine can 
access an unlimited number of 
filles at the same time, so there 
can be an unlimited number of 
files ‘open’ and, of course, data 
can be passed from one file to 
another. In that sense, 
DataDesign is a true relational 
database. At the same time, an 
unlimited number of jobs can 
call upon the DataDesign 
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engine simultaneously - two (or 
more) jobs can even work upon 
the same database at the same 
time! As this can even take 
place over a network (}), 
DataDesign is a true multi-user 
database. Of course, a 
sophisticated ‘record-locking’ 
system has been implemented 
for this, to avoid having one 
job/user accessing a record 
which is currently being 
modified by another job/user. 
DataDesign is quite fast when 
ordering a file, or filtering it 
(select in Archive). Moreover, it is 
the only QL DBMS | know of that 
implements indexes. An index is 
nothing more than a way of 
describing how a database 
should be ordered/selected. 
When one orders a file in 
Archive in a certain way, an 
index of where every record 
should be in that order is built 
up. The same is true in 
DataDesign. However, if one 


Duplicate record 
Undo/Truncate 
Delete record 
Clear all mark 
New record 

Set MEMO field.. 
Clear field.. 
View file... 

Quit program 
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figure 3: The commend menu. Other commands are available In the Files 
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figure 1; The main program - field names on the left, contents on the right 
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figure 2: The filter menu - upto 10 filter levels can be set 


needs a new order in Archive, 
the old one is destroyed, and to 
get it back one must again re- 
order the file. This is not so in 
DataDesign, where one can 
keep each index (and even save 
it onto disk) and access the 
database through these indexes 
at any time. It thus becomes 
possible to have several indexes 
at once in the machine, allowing 
accesses to the data according 
to varying sort and filter criteria. 

As can be seen from the 
above, the DataDesign engine is 
very powerful. It is fast, too. 


The front end 


To take advantage of the 
DataDesign engine, one must 
have a front end, either a 


4 


program built by yourself, or the 
“main program” supplied by 
Progs. This front end to the 
engine presents itself as a 
pointer-driven program (see 
figure one). Anybody who uses 
software under the pointer 
environment will be immediately 
familiar with the software and its 
menu system. 

The “main program’, as it is 
also called, is designed to be as 
simple as possible. It hides most 
of the complexities of the 
DataDesign engine, at the cost 
of not being able to use all of its 
features. It turns the Database 
engine into a simple flatfile 
DBMS - one file at a time only, 
which generally is sufficient for 
most users anyway. This again 
is an advantage over Archive 


which is really quite unusable 
unless one writes at least some 
procedures to drive it (on the 
other hand, public domain, 
purpose-written Archive 
programs abound). 

The main program allows 
easy access to data, one file at a 
time, filtering and sorting 
operations are quite intuitive 
(see figure two) and most 
operations can be handled 
directly with the pointer, 
although keyboard shortcuts are 
available. 

There is not much else to be 
said about the main program, 
which admittedly uses the 
engine at less than half its 
power, On the other hand, it will 
satisfy most users (see figure 
three, some of the commands 
available) - and those who need 
more are probably those who 
would program the engine 
directly anyway. 


It is possible to use the 
engine - and access the data - 
directly from your own programs. 
This is done either via new 


Basic keywords, if you program 
in Basic (these new keywords 
are, of course, supplied), or 
through C functions/library calls 
(also supplied) or through 
assembler routines (all 
described in the manual). This is 
called the API (application 
programmers interface), 

This means that DataDesign 
does not have its own 
programming language like 
Archive - but it does allow you 
to program the database in 
Basic, C, or Assembler (I will 
use Basic from now on, as 
most readers will be familiar 
with that). | must say that | find 
the power of this astonishing, 
as | can have the speed and 
flexibility of Basic (especially 
compared with the Archive 
language) combined with all 
necessary extensions to access 
a database. Moreover, as the 
engine is- entirely  pro- 
grammable, it is perfectly 
possible to write your own front 
end. Of course, applications 
written in Basic with the new 
keywords can also be 
compiled. 

For the technically minded, 
the engine itself is implemented 
as an extension “thing”. When 


programming in assembler, 
standard calls are made to use 
this thing, and all parameters 
are well explained in the 
manual. 

For those programming in C, 
a library of function calls is 
supplied, opening all 
possibilities of the engine. It is 
thus very easy to incorporate all 
calls to the engine into one’s 
Own programs. 


Keywores 


The Basic programmer has 
not been forgotten, of course. An 
important number of new 
keywords are added to Basic, 
through which all functions of 
the engine can be accessed. 
Programming a database never 
is - and never will be - easy and 
DataDesign is no exception, but 
at least here one is in a familiar 
programming environment. 

Of course, programming the 
engine needn't be very 
extensive. It is a relatively simple 
affair to write a (small!) program 
for, say, a report generator. An 
advantage of DataDesign is that 
those who do not feel the need 


to program their engine, do not 
have to pay for this possibility. 
Indeed, DataDesign comes in 
two packages: the engine and 
main program combination on 
the one hand, and the API 
(without the engine), on the other 
hand. So you need not buy the 
API if you do not want to. Of 
course, those who want the API 
will need to buy both. 

On a final note, DataDesign 
comes with the necessary tools 
to convert your old databases 
into the format used by itself 

In summary, | definitely give 
DataDesign a ‘thumbs up’. 


INFORMATION 


Program: DataDesign 3 


Supplier: Progs, Haachstraat 
92 B, 3020 Veltem, Belgium. 


Price: DataDesign 3 (engine 
and main program): 3000 
Belgian Francs; DataDesign 3 
API: 1000 Belgian Francs. 
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Machine Code 


Part 4 


In part 4, Alan Bridewell deals with repeating functions. 


parts 2 and 3 of 


this series, we pro- 
duced loops of 
code which were 


designed to be repeated a fixed 
number of times. So we used a 
‘loop counter’ to count how may 
more times it had to repeat 
before it had finished. 

But there are many situations 
where you cannot know, in 
advance of running the pro- 
gram, just how many times you 
want to repeat the loop. What 
you want is for the loop to keep 
repeating until a certain situation 
occurs which tells you it has 
done enough. For example, if 
you are loading a document into 
a word processor, you want the 
orogram to keep loading until it 
reaches the end of the docu- 
ment, without it being told first 
exactly how long the document 
actually is, 


Status register 


The microprocessor in the QL 
has a special register for this 
purpose called the ‘status regis- 
ter’, We have already used this 
register in the DBRA instruction, 
but it has been used in such an 
automatic and controlled way 


to 1) or ‘clear’ (equal to O) 
depending on the result of cer- 
tain things the program does, 

There are five flags in the reg- 
ister which we need to concern 
ourselves with, and understand 
what it means when they 
become ‘set’ or ‘clear’ 


The 'Z’ or ‘zero’ flag is set if an 
instruction results in a Zero 
being produced. This will hap- 
pen, for example, when a num- 
ber is subtracted from an equal 
number. 

The 'N’ or ‘negative’ flag is set if 
an instruction results in a nega- 
tive number being produced, for 
example, subtracting one num- 
ber from a smaller number. 

The 'C’' or ‘carry flag is set if an 
instruction results in a number 
too big for the register, so a 


Listing 1 


‘carry to the next digit is needed. 
This can result from addition or 
multiplication, 

The ‘V or ‘overflow flag is set if 
the instruction cannot be carried 
out with the numbers given to it, 
for example, if we try to divide by 
Zero, 

The 'X’ or ‘extended’ flag is set 
or cleared when certain types of 
add, subtract, shift or rotate 
instructions move data in or out 
of it. This is definitely not begin- 
ners stuff, so we shall leave it for 
the time being. 


A full explanation of what does 
or does not alter these flags 
really requires a programmer's 
reference manual, but in general 
terms it is fair to say that if an 
instruction MIGHT cause a flag 
to set, then it WILL set if the con- 


HOLDS THE WORD TO PUT INTO SCREEN ADDRESSES 
HOLDS THE SCREEN WORD ROW NUMBER (UP TO FF) 
HOLDS THE SCREEN WORD ROW INCREMENT VALUE (UP TO SFF) 

HOLDS THE SCREEN WORD COLUMN NUMBER (EVEN NO, UP TO $36) 

HOLDS THE SCREEN WORD COLUMN INCREMENT NUMBER (EVEN NO, UP TO #3E) 
HOLDS THE CURRENT SCREEN ADDRESS RELATIVE TO #20000 

HOLDS THE CURRENT ABSOLUTE SCREEN ADDRESS 


dition occurs and it WILL clear if 
the condition does not occur. If 
the instruction could not pro- 
duce the condition, it will leave 
the flag unchanged. 


Branching 


There are different ways to 
use the information stored in the 
status register, but the most 
common, and the one we shall 
look at, is by using ‘conditional 
branching’. There are actually 
14 of these conditional branch- 
ing instructions, each of which 
will cause the program to 
branch to a specified address if 
a particular combination of con- 
ditions occurs. Some of these 
combinations are quite compli- 
cated involving ‘AND’ and ‘OR’. 
We shall deal with two simple, 


HEHEHE EERE EEE EEE EEE EEE EEE EEE HEHE EEE EEE EER EEE HEHEHE 
DRAWING LINES USING INTEGER ADDITION AND MULTPLICATION 
REE HEGRE EE EEE EEE EERE EEE EEE EERE EEE EEE EREE GREER EEE EE HERE EERE 


Di, D2, D3, D4, DS ARE TO BE SET BY THE ‘CALL’ COMMAND FROM SUPERBASIC 


we did not actually need to 
mention it But to find out if a 
particular condition has 
occurred, we need to find out 
what is actually in the register, 
so we need to know something 
about it 

The most important point 
about this register, which is 
completely different from all the 
others, is that the individual dig- 
its it stores are NOT used as 
one number, but are used to 
store quite separate bits of infor- 
mation. These digits (normally 
called ‘flags) become ‘set’ (equal 


MOVEA.L 
MOVEQ 
ADD.W 
CMPI.W 
BPL 
CMPI.W 
BMI 
ADD.W 
CMPI.W 
BPL 
CMPI.W 
BMI 
ADD.W 
MULU 
ADD. W 
ADD.W 
ADDA.W 
MOVE .W 
BRA.S 
MOVE® 
RTS 


#%20000 , AO 
#%0 ,D& 
D3,D2 
#$FF ,D2 
EXIT 
#%0,D2 
EXIT 
D5,D4 
#$3F ,D4 
EXIT 
#%0,D4 
EXIT 
D2,Dé 
#$80,D& 
D4,Dé 
D4,Dé6 
D6,A0 
Di, (AO) 
Loop 
#50, DO 


RESET SCREEN ADDRESS 

RESET RELATIVE SCREEN ADDRESS 
INCREMENT ROW 

ARE WE PASSED LAST ROW? 

YES, THEN EXIT LOOP 

ARE WE PASSED FIRST ROW? 

YES, THEN EXIT LOOP 

INCREMENT COLUMN 

ARE WE PASSED LAST COLUMN? 
YES, THEN EXIT LOOP 

ARE WE PASSED FIRST COLUMN? 
YES, THEN EXIT LOOP 

ROW NO, IN Dé 

ROW NO. X BYTES PER ROW 

ADD COLUMN 

AND AGAIN FOR WORD LENGTH DATA 
ADD TO SCREEN ADDRESS 

LOAD WORD INTO SCREEN ADDRESS 


NO ERROR 
3 RETURN TO SUPERBASIC 
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obvious, and useful ones. 


‘BMI’ stands for ‘branch if 
minus’, and branches if the N 
flag is set, indicating that a 
minus number has been pro- 
duced. 

‘BPL’ stands for ‘branch if plus’, 
and branches if the N flag is 
clear, indicating that a minus 


number has not been produced. 


Although we shall not be 
using them here, | will mention 
two others, which are also very 
useful. 

‘BEQ' stands for ‘branch if 
equal’, and branches if the Z flag 
is set, indicating that a zero has 
been produced. 

‘BNE’ stands for ‘branch if not 
equal’, and branches if the Z flag 
is clear, indicating that a zero 
has not been produced. 


Listing 2 


100 z = RESPR(512) 


subtract the immediate data 
from the data we are comparing 
it with, and alters the flags 
according to the result For 
example, consider the instruc- 
tion 


CMPIW #SFFD2 


Remember the hash (#) tells 
us we have an actual number, 
not an address, and the $ 
means it's a hexadecimal num- 
ber. So the instruction will sub- 
tract #SFF from the contents of 
data register D2 to see what 
happens. (The result of this sub- 
traction is not stored, and D2 
remains unaltered. The only 
affect is on the flags.) 


lf D2 contains a number less 
than #SFF, then we get a minus 
number. This will set the N flag 


110 LBYTES flp2_LISTINGi_code,z 
120 OPEN#3,con_512x256a0x0 


130 REPeat loop 
140 CLS#S 

150 INPUT#S, 
160 INPUT#S, 
170 INPUT#3, 
180 INPUT#S, 
190 INPUT#3, 
200 CLS#S3 


"STARTING ROW? (0 to 255) 
“INCREMENT ROW BY? (0 to 255) 
"STARTING COLUMN? (0 to 63) 
“INCREMENT COLUMN BY? (0 to 63) ",c_inc% 
"WORD TO PUT INTO SCREEN ADDRESSES", word’ 


210 CALL z, word%, row%Z, r_inc%, col%, c_inc%,0,0 


220 PAUSE -1 
230 END REPeat loop 


You might be wondering what 
being equal has to do with the Z 
flag. The answer is quite simply 
in the most common way of 
using the status register, 
Although most instructions will 
alter flags in the register, and we 
can use them at almost any 
time, what we most frequently 
do is use instructions whose 
whole purpose Is to alter the 
flags to give information. These 
are the ‘compare’ instructions, 
which do just that We shall look 
at one of these in detail, to see 
exactly what it does. 

‘CMP! stands for ‘compare 
with immediate data’. Immediate 
data means that the actual num- 
ber used for comparison is in 
the instruction, not in some reg- 
ister or memory location from 
where it has to be fetched first 
What the instruction does is to 





and clear the others. 

lf D2 contains a number 
greater than #$FF, then we get 
a plus number. This will clear all 
the flags. 

lf D2 contains exactly #SFF, 
then we get zero. This will set 
the Z flag and clear the others. 


We can now see what being 
equal has to do with the Z flag, If 
we compare two numbers by 
subtraction, we get zero if they 
are equal (so the Z flag is set), 
but we get either a plus or a 
minus number if they are not 
equal (so the Z flag is cleared), 


Compare and 
branch 


This use of ‘compare’ and 
‘conditional branching’ instruc- 


"rows 
" r_inc% 
*. e€olz 


tions together is a very powerful 
way of controlling what a pro- 
gram does, and is well worth a 
lot of effort to master. 

Before we get round to actual- 
ly using these instructions, | 
would like to introduce the arith- 
metical instructions. 

‘ADD' means simply that It has 
a few variations like most 
instructions, but the most impor- 
tant point is that we can add 
minus numbers as well, result 
ing in a smaller number. ‘SUB 
for ‘subtract’ is just as easy. 

There are two forms of the 
multiply and divide instructions, 
called ‘signed’ and ‘unsigned. 
Microprocessors have a special 
way of dealing with whether a 
number is plus or minus, which 
we shall not deal with here. 
When this special way is being 
used the numbers are said to 
be ‘signed’, Our 
last two pro- 
grams have used 
signed numbers, 
but because our 
assembler can 
deal with them 
automatically, we 
have not had to 
mention the fact. 
But signed num- 
bers need spe- 
cial instructions, 
‘'MULS' and ‘DIVS’ 
standing for 
signed multiplica- 
tion and division. 

lf we ignore 
signs, and treat all numbers as 
positive, we can use ‘MULU' and 
DIVU', standing for unsigned 
multiplication and division. 
MULU will multiply two word 
sized numbers to give a long 
word sized number. 


Biob time 


To illustrate this new material, 
we Shall put together a routine 
to print rows of blobs on the 
screen. They can start anywhere 
on the screen, can go in any 
direction, and will stop at the 
edge of the screen, But before 
we can do this, we need to 
know a little bit more about how 
the screen ram is converted to 
dots on the screen. 

The information for a row of 
pixels is held in 128 consecu- 


tive bytes. Each word (two bytes) 
contains the information for 
either four pixels in 8 colour 
mode, or eight pixels in four 
colour mode. Exactly how the 
different pixels are dealt with 
within the word we shall leave 
for the present We shall simply 
regard each word as dealing 
with a long, flat, multicoloured 
blob, which is actually a short 
row of pixels. There are 64 such 
blobs in each row, with 256 
rows in a screen. 

Clearly, each time we increase 
the screen address by two, we 
move right to the next blob. To 
move to the next blob down, we 
have to increase the screen 
address by 128 (which is #$80 
in hexadecimal). This gives us a 
formula for calculating the 
address of any particular blob 
on the screen, as follows. 


1. Multiply the row number 
(from the top) by #$80. This gets 
us to the correct row. 

2. Add twice the column num- 
ber (from the left), This gets us to 
the correct column. It has to be 
twice the column number 
because each blob is a word (or 
two bytes) long. 

3. Add this to the address of 
the start of the screen RAM 
(#$20000), 

For example, Suppose we 
want the address of the blob 
which is two rows from the top 
and three columns from the left 
The formula gives 


(2 x #$80) + 6 + #520000 - 
#$20106 


Don't worry if you can't do the 
hexadecimal calculation yourself 
- the microprocessor will do it 
for you as long as you give it the 
correct numbers! 


Using CALL 


One last point before we look 
at the actual routine, Clearly it 
would be very clumsy if we had 
to rewrite the program every 
time we wanted to draw a differ- 
ent line. The best thing is to put 
the data for the line into some 
registers, then access the data 
to draw the line we want. The 
SuperBasic command CALL 
enables us to do this. 

Up to-now.we-have used the 
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CALL command with just one 
parameter, the address we 
want to start the machine code 
from. But CALL will take up to 
13 extra parameters, and these 
will be loaded consecutively into 
the registers D1 to D7 then AO 
to A5, before starting from the 
address given. This is just what 
we need to load our data into 
registers before drawing the 
line. 

Listing one shows our rou- 
tine. It would probably be advis- 
able to follow the listing while 
reading through the next bit, so 
that it is clear what part of the 
listing each point refers to. 

As you can see, it expects 
certain registers to be loaded 
with data before it starts, and 
this will be done from 
SuperBasic with the CALL com- 
mand as indicated. Address 
register AO will be used to hold 
the ram address of the blob to 
be drawn, so the loop begins by 
resetting this to #$20000, 
which is the start of the screen 
ram, Data register D6 will be 
used to calculate the relative 
screen address of the blob, so 
we clear it to zero at the start of 
each loop. 

D2 holds the screen row of 
the blob and DS holds the row 
increment value (how many 
rows between each blob). So 
we increase (or decrease) the 
number in D2 by the number in 
D3. Before we go any further, 
we need to know if this new 
row number is still on the 
screen. By comparing D2 with 
#$FF (255 in decimal) we can 
see if we are off the bottom of 
the screen. If the N flag is not 
set, then we are off the bottom, 
and the BPL instruction branch- 
es out of the loop. Similarly, if we 
compare D2 with #$00, the N 
flag set (meaning a minus result) 
would cause the BMI instruction 
to branch out of the loop. 

In exactly the same way, we 
can increment the column by 
increasing (or decreasing) the 
number in D4 by the number in 
D5. By comparing D4 with 
#$3F, a BPL will branch out of 
the loop if we are off the right of 
the screen, and by comparing 
D4 with #$00, a BMI will branch 
out of the loop if we are off the 

left of the screen, 
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Listing 3 


100 
1190 
120 
150 
140 
i150 
160 
170 
180 
190 
200 
210 
220 
230 
240 
220 
260 
270 
230 
290 
3200 
310 
320 
330 
340 
350 
360 
379 
3g0 
390 
400 
410 
420 
430 
440 
450 
440 
470 
480 
490 
300 
310 
320 
530 
340 
330 
360 
370 
380 
370 
600 
610 
620 
630 
640 
650 
660 
670 
480 
590 
700 
710 
720 


REMark Sinclair QL World HEX LOADER v 3 
REMark by Marcus Jeffery & Simon N Goodwin 
3 

CLS: RESTORE :READ space: start=RESPR (space) 
PRINT “Loading Hex...":HEX_LOAD start 
INPUT "Save to file..."3;f% 

SBYTES *%,start,byte: STOP 


DEFine FuNction DECIMAL (x) 
RETurn CODE (h$(x) )-48-7# (hS (x) >"9") 
END DEFine DECIMAL 


DEFine PROCedure HEX _LOAD(start) 
byte=0: checksum=0 
REPeat load_hex_ digits 
READ h¢ 
IF hé="*#"3EXIT load _hex_digits 
IF LEN(h#) MOD 2 
PRINT "Odd number of hex digits ins "3hs% 
STOP 
END IF 
FOR b=i TO LEN(h#) STEP 2 
hb=DECIMAL (b) :1b=DECIMAL (b+1) 
IF -hb<O OR hb>15 OR 1b<O OR 1b>15 
PRINT "Tllegal hex digit in: "3h#:STOP 
END IF 
POKE start+byte, lé*#hb+lb 
checksum=checksum+16*hb+1b 
byte=byteri 
END FOR b 
END REPeat load_hex_digits 
READ check 
IF check< >checksum 
PRINT "Checksum incorrect. Recheck data. ":STOP 
END IF 
PRINT “Checksum correct. Data entered ats "jstart 
END DEFine HEX_LOAD 


: 
REMark Space requirements for the machine cade 


DATA 64 

b 

DATA “207C00020000"; REMark .LOOP MOVEA.L #420000 , AO 
DATA "7COO"; REMark MOVE® #300 , Dé 
DATA "D443": REMark ADD.W DS, D2 
DATA “OC4200FF": REMark CMPI.W #3FF ,D2 
DATA "6A00002C": REMark BPL. EXIT 
DATA "OC420000": REMark CMPI.W #300 , D2 
DATA "6&BO000024"3 REMark BMI EXIT 
DATA "D845": REMark ADD.W DS, D4 
DATA "OC44003F"s: REMark CMPI.W #$3F ,D4 
DATA "6A00001A": REMark BPL EXIT 
DATA "00440000": REMark CMPI.W #00 , D4 
DATA "&SB000012": REMark BMI EXIT 
DATA "DC42":REMark ADD.W D2,Dé 
DATA "“CCFCOO80”": REMark MULU #380 ,Dé 
DATA "DC44"1REMark ADD. W D4,D4 
DATA "DC44";REMark ADD.W D4,Dé 
DATA "DOCS": REMark ADDA.W Dé,A0 
DATA "3081": REMark MOVE. W D1, (AD) 
DATA “60C4": REMar k BRA.S LOOP 
DATA "7000": REMark EXIT MOVEQ #$00 , DO 
DATA "4E75": REMark RTS 

DATA ye ° oa 4658" 


Blob control 





By using these compare and 
branch conditionally instructions, 
we have arranged for the rou- 
tine to leave the loop as soon as 
our blob goes off any edge of 
the screen. 

lf our blob is still on the 
screen, we now have to calcu- 
late its address, using the formu- 
la, as follows: 


1. Add the new row number in 
D2 to D6. 

2. Multiply D6 by #80 to get 
to the right row. 

3, Add the new column num- 
ber in D4 to D6, but do it twice, 
because each blob is a word (2 
bytes) long. 


D6 will now hold the address 
of the blob relative to the screen 
start address (#$20000). To get 
the absolute screen address of 
the blob into AO, we add D6 to 
the #$20000 already in AO. We 
can now print the blob on the 
screen by moving the blob data, 
held in D1 into the address held 
in AO. We end the loop with a 


BRA instruction to start the loop 
over again. 

When we finally leave the loop 
because the blob has wandered 
off the screen, we must tidy up 
by putting zero in DO to make 
sure we get no error message, 
and then return to SuperBasic 
with RTS. 

Listing two shows a 
SuperBasic program to load 
and run the routine. It is 
designed as an endlessly 
repeating loop to input the para- 
meters from the keyboard to 
see what they produce on the 
screen, Once you have got it 
working, and feel you under- 
stand what is going on, it would 
be far more interesting to 
rewrite it to draw lines automatt- 
cally, either at random, or in a 
fixed pattern. If you do not CLS 
between each CALL, you could 
draw patterns, boxes, etc. By 
using CLS, and arranging for 
the parameters to change slow- 
ly and smoothly, you could 
make the line appear to move 
smoothly round the screen. 
Adding a random colour 
change to this, could produce 
some interesting effects. In 


TF SERVICES 


MINERVA 


The ULTIMATE operating system upgrade 


MKII MINERVA with battery for 256 bytes ran 
CRASHPROOF ae & Philips IC rs for pm 
Can autoboot backed ram : 


pERUGOED operating autoboot reset/ 
Multiple Basic/ faster scheduler-graphics (lox of 
lighting)-string handlingy WHEN ERROR/2nd screen/ 
TRACE) foreign keyboard drivers/ *warm’ fast reset/ 
Auto reboot after power failure. V1.97 now with built in 
Multibasic and split OUTPUT baud rates with Hermes. 


Ist upgrade: free, Otherwise £3 (+ £5 for manual if requd) 
(send sae, rom & NEW disk/3 mdvs) 
MK] to MKII upgrade - £30 


MKI....£40 MKII 


Other components/(sockets etc) please phone 


QL REPAIRS 


Fixed price for unmodified QLs, excluding microdrives. 
QLs tested with Thom-EMI rig and ROM software 





£27 including 6 month guarantee 


HERMES 


A replacement QL co-processor for 
the QLs awful IPC 8049 
- Do you get keyboard bounce? 


- Do you find fast serial mput unreliable? 
- Do you want to connect a modem at 19200bps 


If you can say YES to any of these, 
then you need HERMES 


+ 19200bps RELIABLE serial mput - NO QCONNECT. 
. mput baud rates - use serial mouse & print 
° eg 

- Improves ’fuzzy’ and "random 

- Provides extra input/output = 

- Key click 


Fitting is simple. Remove the QL top (8 screws) & 
replace the chip marked 8049 or 8749 next to mdv 1. 


£25 including manual/software 


| Om fiitaurlacs 


The IC bus was designed by Philips to simplify 
interfacg. Minerva MKII clock is driven by an [?C 
chip, & a connector allows connection of other circuits. 
Our extemal circuits will interconnect without Icads. 


Parallel Interface Up to 4 can be connected powered 
by the QL. Each gives 16 imput/output ports. Can be 
usod wherever logic level signals are required - 


Analoguc Interface Up to 4 can be 
connected & powered off QL. Each gives 8 analogue 
to digital mputs, and 2 digital/analogue outputs. For 


temp 
Data sheets. (analogue/parallel I2C chips) 
Control software/mannal (Superbasic exins) 


(First interface purchase includes free 15D/9D lead) 


All prices include post & packing (UK only). Payment by Mastercard/Visa/Eurocard/cheque/postal order/PO Giro 


transfer (58 267 3909). 


12 Bouvcric Place, LONDON W2 IRB 
lax: 071-706 2379 


Tel: 071-724 9053 


MAIL ORDER ONLY - no callers without rmging first. 


Rimg for overscas prices. 


MasterCard | 





mode 8, you can also get flash- 
ing as well. All these involve 
quite elementary SuperBasic 
programming techniques, and 
which | won't elaborate on here. 


Suggestions 


When you feel confident 
enough to start playing around 
with the assembler listing, here 
are some suggestions. 

This loop could be embedded 
in a larger loop which altered 
one or more of the parameters 
for plotting the line. In this way 
you could have several lines 
plotted with one CALL of the 
code. This outer loop could be 
another conditional loop, only 
stopping when parameters 
reach certain values, or it could 
repeat a fixed number of times. 
In fact a whole series of embed- 
ded loops could be put togeth- 
er, each one involving the 
change of one parameter. This 
is not difficult, provided a couple 
of precautions are taken. First, 
each loop must have a different 
label for its own start and its 
own exit address, Secondly, you 





must take care about incompati- 
ble branching conditions, which 
may result in the loops never 
starting, or never stopping! 

Instead of letting the lines stop 
at the edge of the screen, you 
could stop them before they get 
there. By using the spare regis- 
ters to hold the row and column 
numbers to stop at, you could 
out those values into the com- 
pare instructions. In this case it 
would be a CMP, not a CMPI 
instruction, because you would 
be comparing with a value in a 
register, and not with immediate 
data. For example, suppose DO 
held the row you wished to stop 
at. You would use the line 


CMPW DO,D2 


followed by either a BPL or a 
BMI, depending on whether this 
was the furthest right or left you 
wish to go. As before | have 
included the code in Marcus 
and Simon’s Hex Loader for 
those who do not have an 
assembler. This is Listing three. 

Happy coding! 
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| QL Computers | 
Database & & Business Gra 


ce GE £30 0 d in old 


MARCH *93 
NEW MONITOR £50 CHEAPER 


JS COMPLETE QL Computer, PSU, T.V. Lead, PSION V2.35 





All Prices Include 17.5% VAT 


Sn see TS: £120 


Software (W 
). Handbook for QL, Programs, & S 
Free one years membership to QUANTA, A the nije QL ses Grp with ove 40 
free library programs, Newsletters & HEP. WARRANTY. 


WITH DM ROM £100.00 


con at JS RO ? 70. 


QL & PSU oaly. Js £80 TME&65 oes eciigs diansce a3 nade) 


— Accessories 


ke NOTE: EXTERNAL (SER2) 3 BUTTON MOUSB AND SOFTWARB ke 
; WITH EXTRA FUNCTIONS. NOS HERMES COMPATIBLE 


PC KEYBOARD ACE, FITTING, POR FITTING 102 KBY KEYBOARD £ 75.00 

, UK version, 102 key (AT) £ 30.00 
PC KEYBOARD INTERFACE and KEYBO. (INCLUDES FREE JOYSTICK OR PSU) £ 95.00 
CASE and LBAD for FITTING of Keyboard Interface £ 14.00 


JOYSTICK with QL lead 


(no interface required) £ 10.00 
* OL MOUSE, 3 Button, Software controlled, externally mounted, simply fits in SER2 £45 CORDLESS MOUSE £& 55.00 





THE UNIVERSAL DRIVES ARB ALSO SUITABLE FOR ACORN BBC, ATARI ST, 
AMIGA, SPECTRUMS, IBM, AMSTRAD AND OTHER PC COMPATIBLES 


Universal 3.5” 1Mb disk drive, cased with PSU and free QL lesd £ 70,00 2 Units for dual drive £120.00 
Universal 3.5” 2Mb disk drive, as above but 2h capacity £ 90.00 2 Units for dual drive £170.00 
3.5" Mb Uncased disk drive 2 25.00 
4.5" 2Mb Uncased disk drive & 49.00 
Laad for uncased disk drives, or other universal micros £10.00 POWBR SUPPLY ROR UNCASED DRIVES £ 6.00 
; - ‘AL CASBS FOR UNCASED DRIVES £& 6.00 
| Parallel Printers NEW RANGE 

SAMSUNG S$P093 80 Col, 300 cps, $0 NLQ, 3K Print Buffer, Centronics, Tractor Reed/Sheet Reed, Paper Park = £149.00 
ce) COLOUR PRINTER, 24 pin, 200 cps, 50 NLQ, 40K Buffez, Espon LQ255Q/IBM Compatible £259.00 
CENTRONICS PARALLEL Printer for 

QL LEAD FOR SERIAL PRINTERS £10 CANNON BJ10 EX 


rae 


WITH AMBER OR GREEN TEXT FEATURE, IDEAL FOR WORD 
PROCESSING, RECONDITIONED, 90 DAY WARRANTY. 


PHILIPS 14” HIGH RES aC (Al 
OK eet AND QL SELF SENSING AND MANY EXT/L CONTROLS 


a B30 








‘ oad Chetiiges af wetet che 8 peog carts for reformatting in 2 wallets Fred 
i Soaks filing box including 20 mew cartridges 
QL Psion Software V2.35 Includes Quill, Abacus, Archive, and Easel IN WALLET £ 18,00 
QL Psion Software programs £ 10.00 
QL power Unit £ 10.00 Membrane (and instructions) £ 9.00 
TV o N ect ide £ 3.00 QL Top & Bottom Case & 5.00 
ICs ZX 8301 £ 6.00 ZX 8302 £ 3.00 8049 (IPC) £ 3.00 MC 1377 £ 3.00 
MC 68008 = &- 12.00 
QL SERVICE MANUALS & CIRCUIT £25.00 
amen Poymenl TMS: Delivery: 
CWO, Access, VISA et cetera Carriage - £9 
Cheques - allow 10 days Postage £5 





Product subject to availability, E&OE 
TEL: 0753 888866 FAX: 0753 887149 
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UK 
» a, eT 
(12 MONTHS) 


EUROPE 
£32.90 
(12IMIONTHS) 


REST OF 
WORLD 
£40.90 
(12 MONTHS) 


PLEASE SEND YOUR 
SUBSCRIPTION FORM TO 
SINCLAIR QL WORLD, 
THE BLUE BARN, TEW 
LANE, WOOTTON, 
WOODSTOCK, OXON. 

0) Vala At 

TEL:0993 811181 

FAX:0993 811481 





| WISH TO SUBSCRIBE TO 
SINCLAIR QL WORLD 

WE HAVE HAD TO RAISE THE 
COVER PRICE OF QLWORLD 
BUT WILL BE HOLDING LAST 
YEARS SUBSCRIPTION PRICE 
FOR THE IMMEDIATE FUTURE 
ONLY. 


Existing subscribers will not be affected. 


Ceoeeeeeeeeeeeeeeeeeeeeeeeeeds 
PLEASE DEBIT MY CREDIT CARD ACCESS/VISA 

a CLA MEV EIA bes sins «Ske eee perreeeass ann yeneteneeets «ch TIRE ROESL U5 Bute me eee 
EXPIRY DATE 

PLEASE SEND ME A 12 MONTH SUBSCRIPTION TO SINCLAIR 
QL WORLD. 


a TIGL ook Pea: UNBS OV uteic ts oat chat hel nat tra Cet neg 53 poxd ruta c era bgt emt wes 9 ar 
SHR a hs + tax dos ea93 iaaveaead 400 Kova can asi cxa8 404 KegepapeapeR Roan pean Conn gonal TTR 


SINCLAIR QL + twin floppy 
drives, 256k memory, separate 
keyboard, many games £125 
0491 681821 


QL JM EXPANDED, 
SUPER-Q board 512k, 102-key 
keyboard, NEC 3.5" drive, Philips 
monitor, Epson RX-80 printer, 
Psion V2.35, QRAM, QUIMI, 
Manual, DL World Mags, £200 
ono, Tel:0952 676668 evening 


including Psion suite, Eye-Q 
and Games, 40 MDV's, 
Manuals etc, £150 Tel:0256 
764006 evenings only 


QL Minerva Rom,Trump 
Card 3-1/2” D/D,Miracle 
centronics (x2) Tandata 
modem,serial printer, 6 years 
QLWorld, Quanta mags, 
books, software, b/w 
television extra MDV. 





MICRO ADS 


| med MOV KX Lola k=) ololo) k-7 ¢—) a 
REVOLUTIONARY 


NEW SYSTEM 


sensible offers please. Tel: 


JS QL 512K EXPANDERAM 3 (9977 915428 


TK2, Twin 720K Disc Drives, 12" 
Colour Monitor DMP105 Printer 
Manuals, Books £150 Offers 
TEL: 0527 546185 


COMBINES 
Sound logic with A.I. to win £ hundreds £ 
Analysis of Bookies Factors for matches 
Common sense improves chances of Mega-Win 


WITH REGRET, Offers for 
complete QL System. Two 
Computers 14° colour 
monitor, double disk drive, 
ice, original software plus 
more. Books, Manuals. Psion 
organiser and printer. Phone 
for details 0257 265700 


UNIQUE ENTRY SYSTEM 
Takes only a few minutes each week 
Over 300 teams in data-bank. 
Minor league teams automatically added. 
Prior to PC release @ £99.00 
To QL users offered at SPECIAL PRICE £49 


JS QL, Metal case, PC 
keyboard and I/face, twin 3- 
1/2" d/drives and OPD 


m/drives, some software, new 
colour monitor £250 ono. 
Also Tandata modem 3, 

CQVI Digitiser and more. Tel: 
(Derby) 0332 677746 


QL unexpanded JM 
version, shinwa CPA 80Q 
printer, joystick, Software 


COMPLETE OUTFIT QL 
640k js. Twuin Cumana 5.25' 
disc drives. 14" colour 
monitor. Tandata modems. 
Manneshan MT8. Printer 
lightening S.E. Backup QL 
manuals etc. All V@WO offers 
Cliff 0934 812640 


THIS MONTH 


MONEY BACK GUARANTEE - Make a profit in your first full season or 


your money back. 


256K ROM minimum. Discs Only. State 3.5 or 5.25 
CHEQUE OR P.O. TO S.CANTON, OCEAN COMPUTER SERVICES, PO 


BOX 68, NORTH DO. Manchester M8 6NJ 


Tel. 061 740 9002 





Please send coupon to: Advertising Department Sinclair/QL World, The Blue 
Barn, Wootton, Woodstock, Oxon. OX7 1HA, Please place this Classified 
Advertisement in the next issue of Sincair/QL world. 


| enclose a cheque/P.O. to the 
value of £17.65 (inc. VAT) fora 
lineage advertisement of no 
more than 30 words. Please 
make cheques payable to: 
Arcwind Ltd. 





DILWYN JONES COMPUTING 


41 BRO EMRYS, TAL-Y-BONT, BANGOR, 


GWYNEDD, LL57 3YT, GREAT BRITAIN 
TELEPHONE: (0248) 354023 


L SOFTWARE 


A SELECTION FROM OUR RANGE OF NEARLY 100 PRODUCTS FOR THE QL, NO 
ROOM TO ADVERTISE THEM ALL HERE, SO PLEASE ASK FOR OUR 
CATALOGUE (PHONE FOR A COPY OR SEND A LETTER WITH YOUR ADDRESS). 









IMAGE PROCESSOR 2 £15.00 
Easy to use graphics system, featuring usual 
graphic facilities, pixel zoom editing, image 
eo mode conversion etc. 512k, disk 
only. 


SCREEN COMPRESSION £10.00 
Reduce the amount of storage required by 


graphics on disk or microdrive - supports several 
QL formats. 256k, disk only. 


SCREEN DAZZLER £15.00 
Unlike the usual screen savers, which simply turn 
off the display when the keyboard is not used for 
a while, this one can activate various graphical 
displays to provide an attractive means of 
preventing screen burn-in, more like the screen 
savers on other computers. If you have a 
compiler, you can even write your own savers by 
following the instructions in the manual. Pointer 
environment compatible. 


SCANNED CLIPART I £10.00 
NEW! A disk full of compressed scanned pictures 
(decompression program supplied of course) 
which can be used in most QL programs (DTP, 
graphics, etc). Assorted collection, containing 
many pictures you may not find in other 
collections. Large number of pictures, a bargain 
at this price. 128k, disk only. 


PRINTERMASTER £20.00 
Select printer control codes quickly and simply 
from a menu to set fonts, page lengths, etc. 
before printing from programs like Quill, etc. 
128k, diskimdv 


SERMOUSE £40.00 
Albin Hessler’s serial mouse driver system for the 
QL is now available from DJC complete with a 
QL style matching black mouse with 9 pin serial 
connector and UK style port adaptor lead. 
Version 3 driver software. Can now work with The 
Painter too. NB POSTAGE CHARGES BELOW 


MAGAZINES EX-CGH SERVICES 

Ask for a price list of back issues of QL Technical 
Review, QL Leisure Review and QL Adventurer’s 
Forum (all available at time of writing). 


SQUIDQY ROUND THE WORLD £12.50 
An arcade game, ideal for the young at heart! 


128 
5-GAMES PACK £12.50 
5 ‘thinking’ games in one bargain pack, 128k 


SUPPLIES 


























QPACI £19.95 
Ideal companion to QPAC2, consists of small 
accessory programs such as calculator, calendar, 
clocks, alarm clocks, typewriter, etc. All can be 
mouse controlled. Pointer environment files 
included, Can be used with or without QPAC2. 
Expanded memory required, disk only. 


QTYP2 £29.95 
Tony Tebby’s spelling checker program. Check 
spelling as you type OR check existing files 
retrospectively. User interface allows you to write 
programs which use the dictionary facilities. 
English, French and German dictionaries 
included! 


DISA | £29.00 
Interactive pointer driven machine code 
disassembler, 256k ram min. Disk only. 


MEGATOOLKIT £25.00 
EPROM VERSION £40.00 
Large toolkit with over 200 BASIC extensions, 
suitable for use with QLiberator or Turbo. Many 
examples supplied, extensive manual. Suitable 
for unexpanded QL. 


DISCOVER £20.00 
The painless way to move files from QL to PC 
and vice versa, As simple as copying files between 
two disks. 256k ram min., disk only. 


MULTI DISCOVER £30.00 

In addition to Discover facilities, also contains 
CPM, Unix CP10, BBC micro and now Spectrum 
and SAM Coupe file transfer capability. 256k 
min. ram, disk only. 


TEXTIDY £15.00 
Assists Discover with conversion of text files by 
stripping out control codes etc. 256k ram min. 


CONVERT-PCX £10.00 
Used with Discover, allows transfer of bit mapped 
PC clipart graphics in PCX format (a common 
PC file format) to QL screens or Page Designer 
pages. 256k ram, disk only. | 


QL-PC-FILESERVER £24.50 
Link a PC and a QL via a serial port cable and 


EASYPTR III part £40.50 
Simplified pointer environment programming. 
Part I consists of sprite editor, menu editor and 
superbasic extensions to use in your own 
programs. Applications created using Easyptr III 
can be compiled with QLiberator. Requires 
expanded memory, available on disk only. 


EASYPTR III part 2 £20.00 
Consists of appendix manager and enhanced 


LU TCA Moms ig tr Poe 


Consists of Easysource and C library routines etc. 


QLIBERATOR £50.00 


Superb superbasic compiler, compiles virtually all 
of basic plus most toolkit commands, etc. 
Produce faster multitasking code from your basic 
programs. Compile resident extensions, use 
overlays etc. with the latest V3.36. Can be mouse 
controlled. Expanded memory required. 


BUDGET QLIBERATOR = £25.00 

Excellent value, virtually all of superbasic but 
without some of the additional facilities of the full 
version. Not mouse controlled. Works on 
unexpanded QL too. 


DJTOOLKIT £10.00 

Compact toolkit of BASIC extensions, ideal for - 
use with ALiberator. Really useful programming 
commands, can be distributed with your 
compiled programs if you wish. At this price, a 
bargain! Suitable for unexpanded QL. 


LINEDESIGN £100.00 

Vector drawing package, uses outline fonts and 
clipart, move and resize text and graphics 
without loss of quality. Ideal for making posters, 
etc. Supplied with huge range of fonts and clipart 
on TEN disks! The more memory your system 
has, the better! Available on disk only, can be 
mouse controlled (including SERmouse). 


DATA DESIGN 3 £60.00 

Superb, fast pointer driven database with free 
form field structures, with the option of disk 
based for large files if required, or smaller files 
can be kept in memory ‘or speed. You do not 
have to be able to program this version but if you 





























































































































































































































































































add the API package, it can be programmed use this software to enable the two to FLOPPY DISKS £0.40 

from basic, C, or assembler. Expanded memory communicate - the QL can save its files on a DSHD DISKS £0.70 

require disk only. PC's disk systems and print to the PC’s serial port MICRODRIVES £2.50 
for Data Design . £20.00 using normal basic commands like COPY. Works 

on unexpanded QL. DISK LABELS £2.00 

QPAC2 £39.95 On printer roll £2.50 

Tony Tebby’s Superb pointer environment BANTER £25.00 ADDRESS LABELS £2.00 

package. in addition to the pointer environment Simple to use banner maker which uses outline MDV LABELS £2.00 
files themselves, this includes tutorials, extensive fonts for good quality large texts. Prints sideways 

manual, files menu, channels and jobs menus, across up to 4 sheets of paper. Simple to use, MOUSE MATS £2.50 

menu driven, on screen preview before printing, Disk box dividers £3.00 









ee between jobs, hotkeys, etc. Mouse 
or Keyboard controlled, a good introduction to 
ae environment, 256k ram minimum, disk 
only 





in stock once more! 











etc. Suits most Epson compatible printers. 














TERMS: Discounts - buy 2 programs, claim 5% off each, buy 3 or more, claim 10% off each program. Offer applies to software only. POSTAGE - Software is sent post free to UK addresses. 
Overseas please add £1.00 per program for postage (maximum £3.00). Floppy disks and serial mouse - add postage of £2.50. Labelsimouse mats - add postage of £0.50 peritem if only buying 
these. PAYMENT - in UK currency (pounds sterling) only please. Payment by cheque, Eurocheque, Postal Order, cash (send by registered post), or by credit card 
(Visa/Mastercard/Eurocard/Connecy. In case of difficulty contact us first to arrange a payment method if none of these is possible for you. Please make cheques, etc payable to DILWYN JONES 
COMPUTING (not to any other name or abbreviation please, our bank prefers it that way). 












